PWLX_CLOSE_USER_DESKTOP Rückruffunktion (winwlx.h)

[Die Funktion "WlxCloseUserDesktop" ist nicht mehr für die Verwendung von Windows Server 2008 und Windows Vista verfügbar.]

Wird von GINA aufgerufen, um einen alternativen Benutzerdesktop zu schließen und nach dem Schließen des Desktops aufzuräumen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.
 

Syntax

PWLX_CLOSE_USER_DESKTOP PwlxCloseUserDesktop;

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

Parameter

[in] hWlx

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

[in] pDesktop

Gibt einen Zeiger auf eine WLX_DESKTOP Struktur an, die durch Aufrufen der Funktion WlxCreateUserDesktop abgerufen wird.

[in] hToken

Gibt den Handle für das Token des Benutzers an, dessen Desktop geschlossen werden soll.

Rückgabewert

Wenn die Funktion den Desktop erfolgreich schließt, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück.

Bemerkungen

Zusätzlich zum Schließen des Desktops ändert diese Funktion den Zugriff auf die übergeordnete Fensterstation, um ACEs zu entfernen, die während der Erstellung des Benutzerdesktops hinzugefügt wurden.

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_DESKTOP

WlxCreateUserDesktop

WlxInitialize