WlxNegotiate 函式 (winwlx.h)

[WlxNegotiate 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

WlxNegotiate 函式必須由取代 GINA DLL 實作。這是 Winlogon 對 GINA DLL 進行的第一次呼叫。 WlxNegotiate 可讓 GINA 確認它支援已安裝的 Winlogon 版本。

注意 Windows Vista 中會忽略 GINA DLL。

語法

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

[in] dwWinlogonVersion

指定要與 GINA 通訊的 Winlogon 版本。

[out] pdwDllVersion

指出 GINA 支援的 Winlogon 版本。 Winlogon 也會使用此版本資訊來判斷後續呼叫 WlxInitialize 時，哪些分派數據表會傳遞至 GINA。此版本不能大於 dwWinLogonVersion 所指定的版本。

如果 dwWinLogonVersion 指定的 Winlogon 版本大於或等於 pdwDllVersion 中傳回的版本，則函式會傳回 TRUE。傳回 TRUE 時，Winlogon 會繼續初始化。

如果 dwWinLogonVersion 小於 pdwDllVersion，則函式會傳回 FALSE。傳回 FALSE 時，Winlogon 將會終止，而且系統將不會開機。

呼叫 WlxNegotiate 之前， Winlogon 會設定桌面狀態，讓目前的桌面是 Winlogon 桌面，並設定工作站狀態，讓桌面鎖定。