Skip to content

Latest commit

 

History

History
81 lines (64 loc) · 3.12 KB

nf-winwlx-wlxnegotiate.md

File metadata and controls

81 lines (64 loc) · 3.12 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winwlx.WlxNegotiate
WlxNegotiate function (winwlx.h)
The WlxNegotiate function must be implemented by a replacement GINA DLL. This is the first call made by Winlogon to the GINA DLL. WlxNegotiate allows the GINA to verify that it supports the installed version of Winlogon.
WlxNegotiate
WlxNegotiate function [Security]
_gina_wlxnegotiate
security.wlxnegotiate
winwlx/WlxNegotiate
security\wlxnegotiate.htm
security
9e7bab30-5cc6-4c55-82e4-d888e1af59ed
12/05/2018
WlxNegotiate, WlxNegotiate function [Security], _gina_wlxnegotiate, security.wlxnegotiate, winwlx/WlxNegotiate
winwlx.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
WlxNegotiate
winwlx/WlxNegotiate
c++
APIRef
kbSyntax
UserDefined
Winwlx.h
WlxNegotiate

WlxNegotiate function

-description

[The WlxNegotiate function is no longer available for use as of Windows Server 2008 and Windows Vista.]

The WlxNegotiate function must be implemented by a replacement GINA DLL. This is the first call made by Winlogon to the GINA DLL. WlxNegotiate allows the GINA to verify that it supports the installed version of Winlogon.

Note   GINA DLLs are ignored in Windows Vista.
 

-parameters

-param dwWinlogonVersion [in]

Specifies which version of Winlogon will be communicating with the GINA.

-param pdwDllVersion [out]

Indicates which version of Winlogon the GINA supports. This version information is also used by Winlogon to determine which dispatch table is passed to the GINA in subsequent calls to WlxInitialize. This version cannot be greater than the version specified by dwWinLogonVersion.

-returns

If the Winlogon version specified by dwWinLogonVersion is greater than or equal to the version returned in pdwDllVersion, the function returns TRUE. When TRUE is returned, Winlogon will continue to initialize.

If dwWinLogonVersion is less than pdwDllVersion, the function returns FALSE. When FALSE is returned, Winlogon will terminate and the system will not boot.

-remarks

Before calling WlxNegotiate, Winlogon sets the desktop state so that the current desktop is the Winlogon desktop and sets the workstation state so that the desktop is locked.

-see-also

WlxInitialize