PWLX_QUERY_CLIENT_CREDENTIALS funzione di callback (winwlx.h)

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

La funzione WlxQueryClientCredentials viene chiamata da una DLL GINA sostitutiva se Servizi terminal è abilitata.

Nota Le DLL GINA vengono ignorate in Windows Vista.

 

GINA chiama questa funzione per recuperare le credenziali dei client di Servizi terminal remoti che non usano una licenza del connettore Internet.

La DLL GINA può usare queste informazioni per compilare automaticamente una casella di accesso e tentare di registrare l'utente.

Sintassi

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

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

Parametri

[out] pCred

Specifica un puntatore a una struttura WLX_CLIENT_CREDENTIALS_INFO_V1_0 contenente le credenziali del client in caso di restituzione.

Valore restituito

La funzione WlxQueryClientCredentials restituisce uno dei valori seguenti.

Codice restituito	Descrizione
TRUE	Le informazioni sulle credenziali sono state recuperate e restituite in pCred.
FALSE	Le informazioni sulle credenziali non sono state recuperate.

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 il client di Servizi terminal usa una licenza del connettore Internet, la DLL GINA deve chiamare WlxQueryInetConnectorCredentials.

Altre funzioni di supporto winlogon che possono essere chiamate quando i servizi terminal sono WlxDisconnect, WlxQueryInetConnectorCredentials e WlxWin31Migrate.

Requisiti

Requisito	Valore
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

WlxQueryInetConnectorCredentials

WlxWin31Migrate