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.
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 |
|---|---|
|
As informações de credenciais foram recuperadas e retornadas no pCred. |
|
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 |