PWLX_QUERY_TS_LOGON_CREDENTIALS Rückruffunktion (winwlx.h)
Wird von einer GINA-Ersatz-DLL aufgerufen, um Anmeldeinformationen abzurufen, wenn Terminaldienste aktiviert sind. Die GINA-DLL kann diese Informationen dann verwenden, um automatisch ein Anmeldefeld auszufüllen und zu versuchen, den Benutzer anzumelden.
Syntax
PWLX_QUERY_TS_LOGON_CREDENTIALS PwlxQueryTsLogonCredentials;
BOOL PwlxQueryTsLogonCredentials(
[out] PWLX_CLIENT_CREDENTIALS_INFO_V2_0 pCred
)
{...}
Parameter
[out] pCred
Wenn der Rückgabewert TRUE ist, gibt pCred einen Zeiger auf eine WLX_CLIENT_CREDENTIALS_INFO_V2_0-Struktur an, die die Anmeldeinformationen für die automatische Anmeldung enthält.
Rückgabewert
Die WlxQueryTsLogonCredentials-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
Diese Funktion ersetzt die Funktionen WlxQueryClientCredentials und WlxQueryInetConnectorCredentials .
Um auf diese Funktion zuzugreifen, muss die GINA-DLL die WLX_DISPATCH_VERSION_1_4-Struktur verwenden und die Winlogon-Version in ihrem WlxNegotiate-Aufruf auf mindestens WLX_VERSION_1_4 festlegen.
Andere Winlogon-Unterstützungsfunktionen, die aufgerufen werden können, wenn Terminaldienste aktiviert sind, sind WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData 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 |