Compartilhar via


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

Chamado por uma DLL GINA de substituição para recuperar informações de credenciais 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.

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

Sintaxe

PWLX_QUERY_TS_LOGON_CREDENTIALS PwlxQueryTsLogonCredentials;

BOOL PwlxQueryTsLogonCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V2_0 pCred
)
{...}

Parâmetros

[out] pCred

Quando o valor retornado é TRUE, pCred especifica um ponteiro para uma estrutura WLX_CLIENT_CREDENTIALS_INFO_V2_0 que contém as credenciais a serem usadas para logon automático.

Retornar valor

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

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

Comentários

Essa função substitui as funções WlxQueryClientCredentials e WlxQueryInetConnectorCredentials .

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

Outras funções de suporte do Winlogon que podem ser chamadas quando os Serviços de Terminal estão habilitados são WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData 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_CLIENT_CREDENTIALS_INFO_V2_0

WlxDisconnect

WlxQueryClientCredentials

WlxQueryTerminalServicesData

WlxWin31Migrate