Compartilhar via

Função WTSOpenServerExA (wtsapi32.h)

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

Sintaxe

HANDLE WTSOpenServerExA(
  [in] LPSTR pServerName
);

Parâmetros

[in] pServerName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome NetBIOS do servidor.

Valor de retorno

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 inválido. Você pode testar a validade do identificador usando-o em outra chamada de função.

Observações

Se o servidor especificado pelo parâmetro pServerName for um servidor host de sessão rd, o comportamento dessa função será idêntico ao da função WTSOpenServer.

Para trabalhar com sessões em execução em máquinas virtuais no servidor Host de Virtualização de Área de Trabalho Remota no qual o aplicativo de chamada está em execução, especifique WTS_CURRENT_SERVER_NAME para o parâmetro pServerName.

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

Nota

O cabeçalho wtsapi32.h define WTSOpenServerEx 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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7
servidor com suporte mínimo Windows Server 2008 R2
da Plataforma de Destino Windows
cabeçalho wtsapi32.h
biblioteca Wtsapi32.lib
de DLL Wtsapi32.dll

Consulte também

WTSCloseServer

WTSOpenServer

  • Last updated on