PWLX_SET_RETURN_DESKTOP Rückruffunktion (winwlx.h)
[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.
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 |
|---|---|
|
Der Funktionsaufruf war erfolgreich. |
|
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 |