Funzione WlxInitialize (winwlx.h)

Articolo
03/08/2023

[La funzione WlxInitialize non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La funzione WlxInitialize deve essere implementata da una DLL GINA sostitutiva. Winlogon chiama questa funzione una volta per ogni stazione finestra presente nel computer. Attualmente, il sistema operativo supporta una stazione finestra per workstation.

Nota Le DLL GINA vengono ignorate in Windows Vista.

Il contesto restituito da questa funzione verrà passato alla GINA in tutte le chiamate successive.

Sintassi

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

Parametri

[in] lpWinsta

Puntatore al nome della stazione finestra inizializzata.

[in] hWlx

Handle per Winlogon. L'GINA deve fornire questo handle in tutte le chiamate a funzioni di supporto Winlogon che coinvolgono questa stazione finestra.

[in] pvReserved

Questo parametro è riservato per l'uso futuro e deve essere impostato su NULL.

[in] pWinlogonFunctions

Puntatore a una tabella di invio delle funzioni di supporto Winlogon. Il contenuto della tabella dipende dalla versione della DLL GINA restituita dalla chiamata WlxNegotiate . Questa tabella non cambia, che consente alla DLL GINA di fare riferimento alla tabella senza copiarla. Se la DLL GINA deve eseguire una copia della tabella, deve chiamare WlxGetOption e specificare WLX_OPTION_DISPATCH_TABLE_SIZE per il parametro Option .

Valore	Significato
WLX_DISPATCH_VERSION_1_4	Tabella di invio Winlogon - versione 1.4
WLX_DISPATCH_VERSION_1_3	Tabella di invio Winlogon - versione 1.3
WLX_DISPATCH_VERSION_1_2	Tabella di invio Winlogon - versione 1.2
WLX_DISPATCH_VERSION_1_1	Tabella Winlogondispatch - versione 1.1
WLX_DISPATCH_VERSION_1_0	Tabella di invio Winlogon - versione 1.0

[out] pWlxContext

Puntatore a un puntatore a un VOID che conterrà l'indirizzo del contesto GINA per questa stazione finestra. Questo contesto viene passato in tutte le chiamate successive alla GINA da Winlogon. La DLL GINA gestisce qualsiasi memoria usata dal contesto. Il puntatore di contesto può essere modificato in un secondo momento chiamando la funzione WlxSetOption con WLX_OPTION_CONTEXT_POINTER.

Valore restituito

Se la funzione inizializza correttamente la DLL GINA, la funzione restituisce TRUE.

Se la funzione ha esito negativo o se la DLL GINA non è stata inizializzata, la funzione restituisce FALSE. Winlogon termina e il sistema non verrà avviato.

Commenti

WlxInitialize viene chiamato una volta per ogni stazione finestra presente nel computer.

Attualmente è supportata solo una singola stazione finestra denominata Winsta0.

Prima di chiamare WlxInitialize, Winlogon imposta lo stato desktop in modo che il desktop corrente sia il desktop Winlogon e imposta lo stato della workstation in modo che il desktop sia bloccato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winwlx.h

Vedi anche

WlxNegotiate