Compartilhar via


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

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

Chamado por uma DLL GINA de substituição se os Serviços de Terminal estiverem habilitados. GINA chama essa função para determinar se o servidor terminal está usando o licenciamento do conector da Internet e para recuperar informações de credenciais .

Nota As DLLs GINA são ignoradas no Windows Vista.
 
Em seguida, 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_IC_CREDENTIALS PwlxQueryIcCredentials;

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

Parâmetros

[out] pCred

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

Valor retornado

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

Código de retorno Descrição
TRUE
O licenciamento do conector da Internet está habilitado.
FALSE
O licenciamento do conector da Internet não está disponível.

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 os Serviços de Terminal não estiverem usando uma licença de conector da Internet, a DLL gina deverá chamar WlxQueryClientCredentials.

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

   
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

WlxQueryClientCredentials

WlxWin31Migrate