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 |