PWLX_CREATE_USER_DESKTOP Rückruffunktion (winwlx.h)

Artikel
08/28/2023

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

Wird von GINA aufgerufen, um alternative Anwendungsdesktops für den Benutzer zu erstellen.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

PWLX_CREATE_USER_DESKTOP PwlxCreateUserDesktop;

BOOL PwlxCreateUserDesktop(
  [in]  HANDLE hWlx,
  [in]  HANDLE hToken,
  [in]  DWORD Flags,
  [in]  PWSTR pszDesktopName,
  [out] PWLX_DESKTOP *ppDesktop
)
{...}

Parameter

[in] hWlx

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

[in] hToken

Gibt das Handle für das Token des Benutzers an, für den der Desktop erstellt wird.

[in] Flags

Gibt den Zugriff auf den Desktop an. Geben Sie eine der folgenden Optionen an.

Wert	Bedeutung
WLX_CREATE_INSTANCE_ONLY	Gibt an, dass nur dieser instance des Benutzers Zugriff hat.
WLX_CREATE_USER	Gibt an, dass jeder instance dieses Benutzers Zugriff hat.

[in] pszDesktopName

Gibt den Namen des zu erstellenden Desktops an.

[out] ppDesktop

Wenn der Desktop erstellt wird, wird ein Zeiger auf eine WLX_DESKTOP-Struktur für den neuen Desktop zurückgegeben. Dieser Zeiger kann in einem Aufruf von WlxSetReturnDesktop verwendet werden, um dies zum aktuellen Desktop zu machen, nachdem ein SAS-Ereignis verarbeitet wurde.

Rückgabewert

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

Rückgabecode	Beschreibung
TRUE	Der Desktop wurde erstellt.
FALSE	Der Desktop wurde nicht erstellt.

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

WlxInitialize

WlxSetReturnDesktop