Funzione WlxInitialize (winwlx.h)

[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.

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 .

[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

Vedi anche

WlxNegotiate