função de retorno de chamada PWLX_QUERY_TERMINAL_SERVICES_DATA (winwlx.h)

Artigo
03/04/2024

[A função WlxQueryTerminalServicesData não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

Chamado por GINA para recuperar as informações de configuração do usuário dos Serviços de Terminal após o logon de um usuário.

Nota As DLLs GINA são ignoradas no Windows Vista.

Sintaxe

PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;

DWORD PwlxQueryTerminalServicesData(
  [in]  HANDLE hWlx,
  [out] PWLX_TERMINAL_SERVICES_DATA pTSData,
  [in]  WCHAR *UserName,
  [in]  WCHAR *Domain
)
{...}

Parâmetros

[in] hWlx

Especifica o identificador Winlogon passado para GINA na chamada WlxInitialize .

[out] pTSData

Aponta para uma estrutura que conterá as informações de configuração do usuário específicas dos Serviços de Terminal.

[in] UserName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que especifica o nome do usuário recém-conectado.

[in] Domain

Ponteiro para uma cadeia de caracteres largos terminada em nulo que especifica o domínio do usuário conectado recentemente.

Retornar valor

A função WlxQueryTerminalServicesData retornará zero se as informações de configuração do usuário forem recuperadas com êxito. Caso contrário, ele retornará um código de erro.

Comentários

WlxQueryTerminalServicesData deve ser chamado de dentro da implementação do GINA de WlxLoggedOutSAS depois que um usuário tiver sido autenticado.

Para acessar essa função, a DLL gina deve usar a estrutura WLX_DISPATCH_VERSION_1_3 e definir a versão do Winlogon como pelo menos WLX_VERSION_1_3 em sua chamada WlxNegotiate .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winwlx.h