WlxInitialize-Funktion (winwlx.h)

Artikel
03/13/2024

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

Die WlxInitialize-Funktion muss durch eine GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion einmal für jede Fensterstation auf dem Computer auf. Derzeit unterstützt das Betriebssystem eine Fensterstation pro Arbeitsstation.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Der von dieser Funktion zurückgegebene Kontext wird bei allen nachfolgenden Aufrufen an die GINA zurückgegeben.

Syntax

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

Parameter

[in] lpWinsta

Ein Zeiger auf den Namen der Fensterstation, die initialisiert wird.

[in] hWlx

Ein Handle für Winlogon. Die GINA muss diesen Handle in allen Aufrufen von Winlogon-Unterstützungsfunktionen bereitstellen, die diese Fensterstation betreffen.

[in] pvReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

[in] pWinlogonFunctions

Ein Zeiger auf eine Winlogon-Funktionsverteilungstabelle. Der Inhalt der Tabelle hängt von der GINA-DLL-Version ab, die vom WlxNegotiate-Aufruf zurückgegeben wird. Diese Tabelle ändert sich nicht, sodass die GINA-DLL ohne Kopieren auf die Tabelle verweisen kann. Wenn die GINA-DLL eine Kopie der Tabelle erstellen muss, sollte sie WlxGetOption aufrufen und WLX_OPTION_DISPATCH_TABLE_SIZE für den Option-Parameter bereitstellen.

Wert	Bedeutung
WLX_DISPATCH_VERSION_1_4	Winlogon-Verteiltabelle – Version 1.4
WLX_DISPATCH_VERSION_1_3	Winlogon-Verteiltabelle – Version 1.3
WLX_DISPATCH_VERSION_1_2	Winlogon-Verteiltabelle – Version 1.2
WLX_DISPATCH_VERSION_1_1	Winlogondispatch-Tabelle – Version 1.1
WLX_DISPATCH_VERSION_1_0	Winlogon-Verteiltabelle – Version 1.0

[out] pWlxContext

Ein Zeiger auf einen Zeiger auf einen VOID , der die Adresse des GINA-Kontexts für diese Fensterstation enthält. Dieser Kontext wird in allen nachfolgenden Aufrufen an die GINA von Winlogon übergeben. Die GINA-DLL verwaltet den vom Kontext verwendeten Arbeitsspeicher. Der Kontextzeiger kann später geändert werden, indem die WlxSetOption-Funktion mit WLX_OPTION_CONTEXT_POINTER aufgerufen wird.

Rückgabewert

Wenn die Funktion die GINA-DLL erfolgreich initialisiert, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt oder die GINA-DLL nicht initialisiert wurde, gibt die Funktion FALSE zurück. Winlogon wird beendet, und das System wird nicht gestartet.

Hinweise

WlxInitialize wird für jede Fensterstation auf dem Computer einmal aufgerufen.

Derzeit wird nur eine einzelne Fensterstation namens Winsta0 unterstützt.

Vor dem Aufrufen von WlxInitialize legt Winlogon den Desktopstatus so fest, dass der aktuelle Desktop der Winlogon-Desktop ist, und legt den Arbeitsstationsstatus so fest, dass der Desktop gesperrt ist.

Anforderungen

Anforderung	Wert
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

WlxNegotiate

Freigeben über