Compartilhar via


Função WTSOpenServerA (wtsapi32.h)

Abre um identificador para o servidor do Host da Sessão da Área de Trabalho Remota (Host da Sessão da Área de Trabalho Remota) especificado.

Sintaxe

HANDLE WTSOpenServerA(
  [in] LPSTR pServerName
);

Parâmetros

[in] pServerName

Ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome NetBIOS do servidor host da sessão rd.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o servidor especificado.

Se a função falhar, ela retornará um identificador que não é válido. Você pode testar a validade do identificador usando-o em outra chamada de função.

Comentários

Quando terminar de usar o identificador retornado por WTSOpenServer, libere-o chamando a função WTSCloseServer .

Você não precisa abrir um identificador para operações executadas no servidor Host da Sessão de Área de Trabalho Remota no qual seu aplicativo está em execução. Em vez disso, use a WTS_CURRENT_SERVER_HANDLE constante.

Observação

O cabeçalho wtsapi32.h define WTSOpenServer como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wtsapi32.h
Biblioteca Wtsapi32.lib
DLL Wtsapi32.dll

Confira também

WTSCloseServer