WlxNegotiate 函数 (winwlx.h)

[自 Windows Server 2008 和 Windows Vista 起，WlxNegotiate 函数不再可用。]

WlxNegotiate 函数必须由替换 GINA DLL 实现。这是 Winlogon 对 GINA DLL 进行的第一次调用。 WlxNegotiate 允许 GINA 验证它是否支持已安装的 Winlogon 版本。

注意在 Windows Vista 中忽略 GINA DLL。

语法

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

[in] dwWinlogonVersion

指定哪个版本的 Winlogon 将与 GINA 通信。

[out] pdwDllVersion

指示 GINA 支持的 Winlogon 版本。 Winlogon 还使用此版本信息来确定在后续调用 WlxInitialize 时将哪个调度表传递给 GINA。此版本不能大于 dwWinLogonVersion 指定的版本。

如果 dwWinLogonVersion 指定的 Winlogon 版本大于或等于 pdwDllVersion 中返回的版本，则函数返回 TRUE。返回 TRUE 时，Winlogon 将继续初始化。

如果 dwWinLogonVersion 小于 pdwDllVersion，则函数返回 FALSE。返回 FALSE 时，Winlogon 将终止，系统不会启动。

在调用 WlxNegotiate 之前， Winlogon 设置桌面状态，使当前桌面为 Winlogon 桌面，并设置工作站状态，使桌面处于锁定状态。