PWLX_QUERY_CLIENT_CREDENTIALS Rückruffunktion (winwlx.h)

  • Artikel

[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.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.
 
GINA ruft diese Funktion auf, um die Anmeldeinformationen von Remoteterminaldienste-Clients abzurufen, die keine Internetconnectorlizenz verwenden.

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

Weitere Informationen

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate