PWLX_SET_RETURN_DESKTOP Rückruffunktion (winwlx.h)

Artikel
08/28/2023

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

Wird von GINA aufgerufen, um den alternativen Anwendungsdesktop anzugeben, zu dem Winlogon wechselt , wenn die aktuelle SAS-Ereignisverarbeitungsfunktion ( Secure Attention Sequence ) abgeschlossen ist.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

Parameter

[in] hWlx

Gibt das Winlogon-Handle an, das im WlxInitialize-Aufruf an GINA übergeben wird.

[in] pDesktop

Zeiger auf Desktopinformationen zum alternativen Desktop. Dieser Desktop wird durch Aufrufen der Funktion WlxCreateUserDesktop erstellt.

Rückgabewert

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

Rückgabecode	Beschreibung
TRUE	Der Funktionsaufruf war erfolgreich.
FALSE	Fehler beim Festlegen des Rückgabedesktops durch den Funktionsaufruf.

Hinweise

WlxSetReturnDesktop kann nur in WlxLoggedOnSAS - oder WlxWkstaLockedSAS-Routinen aufgerufen werden. Versuche, diese Funktion zu anderen Zeiten aufzurufen, schlagen fehl.

Wenn ein Handle für den Desktop bereitgestellt wird, dupliziert Winlogon das Handle. Wenn kein Handle bereitgestellt wird, versucht Winlogon, den Desktop namens im pDesktop-Parameter zu öffnen. Wenn der bereitgestellte Desktop ungültig ist oder der Winlogon- oder Bildschirmschoner-Desktop ist, schlägt der Aufruf fehl.

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

Freigeben über