Função WTSQueryListenerConfigA (wtsapi32.h)

Artigo
11/20/2024

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 de 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.

Valor de retorno

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.

Observações

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.

Nota

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 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

WTSGetListenerSecurity

WTSLISTENERCONFIG

Compartilhar via