PWLX_QUERY_IC_CREDENTIALS funzione di callback (winwlx.h)

  • Articolo

[La funzione WlxQueryInetConnectorCredentials non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

Chiamato da una DLL GINA sostitutiva se Servizi terminal è abilitato. GINA chiama questa funzione per determinare se il server terminal usa licenze del connettore Internet e per recuperare le informazioni sulle credenziali .

Nota Le DLL GINA vengono ignorate in Windows Vista.
 
La DLL GINA può quindi usare queste informazioni per compilare automaticamente una casella di accesso e tentare di registrare l'utente.

Sintassi

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

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

Parametri

[out] pCred

Quando il valore restituito è TRUE, pCred specifica un puntatore a una struttura WLX_CLIENT_CREDENTIALS_INFO_V1_0 che contiene le credenziali da usare per l'accesso automatico.

Valore restituito

La funzione WlxQueryInetConnectorCredentials restituisce uno dei valori seguenti.

Codice restituito Descrizione
TRUE
 La licenza del connettore Internet è abilitata.
FALSE
 La licenza del connettore Internet non è disponibile.

Commenti

La DLL GINA è responsabile della chiamata a LocalFree per liberare le risorse usate da questa struttura quando la struttura non è più necessaria.

Per accedere a questa funzione, la DLL GINA deve usare la struttura WLX_DISPATCH_VERSION_1_3 e impostare la versione winlogon su almeno WLX_VERSION_1_3 nella chiamata WlxNegotiate .

Se Servizi terminal non usa una licenza del connettore Internet, la DLL GINA deve chiamare WlxQueryClientCredentials.

Altre funzioni di supporto Winlogon che possono essere chiamate quando Servizi Terminal è abilitato sono WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData e WlxWin31Migrate.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winwlx.h

Vedi anche

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryClientCredentials

WlxWin31Migrate