PWLX_GET_SOURCE_DESKTOP Rückruffunktion (winwlx.h)

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

Wird von GINA aufgerufen, um den Namen und das Handle des Desktops zu bestimmen, der aktuell war, bevor Winlogon zum Winlogon-Desktop wechselte.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

 

GINA kann diese Funktion verwenden, um ihr Verhalten abhängig vom ursprünglichen Desktop zu ändern.

Syntax

PWLX_GET_SOURCE_DESKTOP PwlxGetSourceDesktop;

BOOL PwlxGetSourceDesktop(
  [in]  HANDLE hWlx,
  [out] PWLX_DESKTOP *ppDesktop
)
{...}

Parameter

[in] hWlx

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

[out] ppDesktop

Empfängt einen Zeiger auf eine WLX_DESKTOP Struktur, die die erforderlichen Informationen enthält, die den Desktop beschreiben. Dieser Zeiger kann mit LocalFree freigegeben werden.

Rückgabewert

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

Rückgabecode	Beschreibung
TRUE	Der Aufruf war erfolgreich.
FALSE	Der Aufruf schlug 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

LocalFree

WLX_DESKTOP

WlxInitialize