共用方式為


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