Funzione WlxNegotiate (winwlx.h)

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

La funzione WlxNegotiate deve essere implementata da una DLL GINA sostitutiva. Questa è la prima chiamata effettuata da Winlogon alla DLL GINA. WlxNegotiate consente all'GINA di verificare che supporti la versione installata di Winlogon.

Nota Le DLL GINA vengono ignorate in Windows Vista.
 

Sintassi

BOOL WlxNegotiate(
  [in]  DWORD  dwWinlogonVersion,
  [out] PDWORD pdwDllVersion
);

Parametri

[in] dwWinlogonVersion

Specifica la versione di Winlogon che comunica con l'GINA.

[out] pdwDllVersion

Indica quale versione di Winlogon supporta l'GINA. Queste informazioni sulla versione vengono usate anche da Winlogon per determinare quale tabella di invio viene passata alla GINA nelle chiamate successive a WlxInitialize. Questa versione non può essere maggiore della versione specificata da dwWinLogonVersion.

Valore restituito

Se la versione Winlogon specificata da dwWinLogonVersion è maggiore o uguale alla versione restituita in pdwDllVersion, la funzione restituisce TRUE. Quando viene restituito TRUE, Winlogon continuerà a inizializzare.

Se dwWinLogonVersion è minore di pdwDllVersion, la funzione restituisce FALSE. Quando viene restituito FALSE, Winlogon termina e il sistema non verrà avviato.

Commenti

Prima di chiamare WlxNegotiate, 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

WlxInitialize