PWLX_QUERY_CLIENT_CREDENTIALS Rückruffunktion (winwlx.h)
[Die WlxQueryClientCredentials-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]
Die WlxQueryClientCredentials-Funktion wird von einer GINA-Ersatz-DLL aufgerufen, wenn Terminaldienste aktiviert sind.
Die GINA-DLL kann diese Informationen verwenden, um automatisch ein Anmeldefeld auszufüllen und zu versuchen, den Benutzer anzumelden.
Syntax
PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;
BOOL PwlxQueryClientCredentials(
[out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}
Parameter
[out] pCred
Gibt einen Zeiger auf eine WLX_CLIENT_CREDENTIALS_INFO_V1_0 Struktur an, die bei der Rückgabe die Anmeldeinformationen des Clients enthält.
Rückgabewert
Die WlxQueryClientCredentials-Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Anmeldeinformationen wurden abgerufen und in pCred zurückgegeben. |
|
Die Anmeldeinformationen wurden nicht abgerufen. |
Hinweise
Die GINA-DLL ist für den Aufruf von LocalFree verantwortlich, um die von dieser Struktur verwendeten Ressourcen freizugeben, wenn die Struktur nicht mehr benötigt wird.
Um auf diese Funktion zugreifen zu können, muss die GINA-DLL die WLX_DISPATCH_VERSION_1_3-Struktur verwenden und die Winlogon-Version in ihrem WlxNegotiate-Aufruf auf mindestens WLX_VERSION_1_3 festlegen.
Wenn der Terminaldienste-Client eine Internetconnectorlizenz verwendet, muss die GINA-DLL WlxQueryInetConnectorCredentials aufrufen.
Andere Winlogon-Unterstützungsfunktionen, die aufgerufen werden können, wenn Terminaldienste aktiviert sind, sind WlxDisconnect, WlxQueryInetConnectorCredentials und WlxWin31Migrate.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winwlx.h |