Compartilhar via


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

[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

Confira também

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxLoggedOutSAS

WlxNegotiate

WlxQueryClientCredentials

WlxWin31Migrate