WlxInitialize 函式 (winwlx.h)

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

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

語法

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。

[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 桌面，並設定工作站狀態，讓桌面鎖定。

規格需求

另請參閱

WlxNegotiate