Função WTSQueryListenerConfigA (wtsapi32.h)

  • Artigo

Recupera informações de configuração para um ouvinte dos Serviços de Área de Trabalho Remota.

Sintaxe

BOOL WTSQueryListenerConfigA(
  [in]  HANDLE              hServer,
  [in]  PVOID               pReserved,
  [in]  DWORD               Reserved,
  [in]  LPSTR               pListenerName,
  [out] PWTSLISTENERCONFIGA pBuffer
);

Parâmetros

[in] hServer

Um identificador para um servidor Host da Sessão de Área de Trabalho Remota. Sempre defina esse parâmetro como WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Esse parâmetro é reservado. Sempre defina esse parâmetro como NULL.

[in] Reserved

Esse parâmetro é reservado. Sempre defina esse parâmetro como zero.

[in] pListenerName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do ouvinte a ser consultado.

[out] pBuffer

Um ponteiro para uma estrutura WTSLISTENERCONFIG que recebe as informações de configuração do ouvinte recuperadas.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

Essa função não recupera o descritor de segurança para o ouvinte. Para recuperar o descritor de segurança, chame a função WTSGetListenerSecurity .

Observação

O cabeçalho wtsapi32.h define WTSQueryListenerConfig como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wtsapi32.h
Biblioteca Wtsapi32.lib
DLL Wtsapi32.dll

Confira também

WTSGetListenerSecurity

WTSLISTENERCONFIG