PWLX_QUERY_IC_CREDENTIALS Rückruffunktion (winwlx.h)

[Die WlxQueryInetConnectorCredentials-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Wird von einer GINA-Ersatz-DLL aufgerufen, wenn Terminaldienste aktiviert sind. GINA ruft diese Funktion auf, um zu bestimmen, ob der Terminalserver die Internetconnectorlizenzierung verwendet, und um Anmeldeinformationen abzurufen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

 

Die GINA-DLL kann diese Informationen dann verwenden, um automatisch ein Anmeldefeld auszufüllen und zu versuchen, den Benutzer anzumelden.

Syntax

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

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

Parameter

[out] pCred

Wenn der Rückgabewert TRUE ist, gibt pCred einen Zeiger auf eine WLX_CLIENT_CREDENTIALS_INFO_V1_0-Struktur an, die die Anmeldeinformationen für die automatische Anmeldung enthält.

Rückgabewert

Die WlxQueryInetConnectorCredentials-Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
TRUE	Die Lizenzierung von Internetconnectors ist aktiviert.
FALSE	Die Lizenzierung von Internetconnectors ist nicht verfügbar.

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 Terminaldienste keine Internetconnectorlizenz verwenden, muss die GINA-DLL WlxQueryClientCredentials aufrufen.

Andere Winlogon-Unterstützungsfunktionen, die aufgerufen werden können, wenn Terminaldienste aktiviert sind, sind WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData und WlxWin31Migrate.

Anforderungen

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

WlxQueryClientCredentials

WlxWin31Migrate