PWLX_QUERY_TS_LOGON_CREDENTIALS Rückruffunktion (winwlx.h)

Artikel
03/06/2024

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.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

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
TRUE	Die Anmeldeinformationen wurden abgerufen und in pCred zurückgegeben.
FALSE	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