Compartilhar via


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

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

A função WlxQueryClientCredentials é chamada por uma DLL GINA de substituição se os Serviços de Terminal estiverem habilitados.

Nota As DLLs GINA são ignoradas no Windows Vista.
 
GINA chama essa função para recuperar as credenciais de clientes remotos dos Serviços de Terminal que não estão usando uma licença de conector da Internet.

A DLL gina pode usar essas informações para preencher uma caixa de logon automaticamente e tentar fazer logon do usuário.

Sintaxe

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

BOOL PwlxQueryClientCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

Parâmetros

[out] pCred

Especifica um ponteiro para uma estrutura WLX_CLIENT_CREDENTIALS_INFO_V1_0 que contém as credenciais do cliente no retorno.

Retornar valor

A função WlxQueryClientCredentials retorna um dos valores a seguir.

Código de retorno Descrição
TRUE
As informações de credenciais foram recuperadas e retornadas no pCred.
FALSE
As informações de credenciais não foram recuperadas.

Comentários

A DLL gina é responsável por chamar LocalFree para liberar os recursos usados por essa estrutura quando a estrutura não for mais necessária.

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 .

Se o cliente dos Serviços de Terminal estiver usando uma licença de conector da Internet, a DLL gina deverá chamar WlxQueryInetConnectorCredentials.

Outras funções de suporte do Winlogon que podem ser chamadas quando os Serviços de Terminal estão habilitados são WlxDisconnect, WlxQueryInetConnectorCredentials e WlxWin31Migrate.

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

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate