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.
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 |
|---|---|
|
Die Lizenzierung von Internetconnectors ist aktiviert. |
|
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 |