Freigeben über


PWLX_CREATE_USER_DESKTOP Rückruffunktion (winwlx.h)

[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