WlxInitialize 函式 (winwlx.h)

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

WlxInitialize 函式必須由取代 GINA DLL 實作。 Winlogon 會針對計算機上存在的每個視窗月臺呼叫此函式一次。 操作系統目前支援每個工作站一個視窗月臺。

注意 Windows Vista 中會忽略 GINA DLL。

 

此函式傳回 的內容 將會在所有後續呼叫中傳回至 GINA。

語法

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

參數

[in] lpWinsta

要初始化之視窗月臺名稱的指標。

[in] hWlx

Winlogon 的句柄。 GINA 必須在涉及此視窗月臺的所有 Winlogon 支援函式呼叫中提供此句柄。

[in] pvReserved

此參數保留供日後使用，且必須設定為 NULL。

[in] pWinlogonFunctions

Winlogon 支援函式分派數據表的指標。 數據表的內容取決於 WlxNegotiate 呼叫所傳回的 GINA DLL 版本。 此資料表不會變更，這可讓 GINA DLL 在不複製數據表的情況下參考數據表。 如果 GINA DLL 需要建立資料表的複本，它應該呼叫 WlxGetOption ，併為 Option 參數提供WLX_OPTION_DISPATCH_TABLE_SIZE。

值	意義
WLX_DISPATCH_VERSION_1_4	Winlogon 分派數據表 - 1.4 版
WLX_DISPATCH_VERSION_1_3	Winlogon 分派數據表 - 1.3 版
WLX_DISPATCH_VERSION_1_2	Winlogon 分派表 - 1.2 版
WLX_DISPATCH_VERSION_1_1	Winlogondispatch 數據表 - 1.1 版
WLX_DISPATCH_VERSION_1_0	Winlogon 分派表 - 1.0 版

[out] pWlxContext

VOID 指標的指標，其中包含這個視窗月臺之 GINA 內容的位址。 此內容會從 Winlogon 傳遞至 GINA 的所有後續呼叫。 GINA DLL 會管理內容所使用的任何記憶體。 稍後可以使用 WLX_OPTION_CONTEXT_POINTER呼叫 WlxSetOption 函式來變更內容指標。

傳回值

如果函式成功初始化 GINA DLL，則函式會傳回 TRUE。

如果函式失敗，或 GINA DLL 未初始化，則函式會傳回 FALSE。 Winlogon 將會終止，而且系統將不會開機。

備註

計算機上每個視窗月臺都會呼叫 WlxInitialize 一次。

目前僅支援稱為 Winsta0 的單一視窗月臺。

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

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	winwlx.h

另請參閱

WlxNegotiate