WlxStartApplication 函式 (winwlx.h)

[自 Windows Server 2008 和 Windows Vista 起，不再提供 WlxStartApplication 函式。

WlxStartApplication 函式可由取代 GINA DLL 實作。當系統需要在使用者的內容中啟動應用程式時，Winlogon 會呼叫此函式。

系統可能需要應用程式在使用者的內容中啟動兩個原因：

注意 Windows Vista 中會忽略 GINA DLL。

如果適當，GINA 可以使用 WlxStartApplication 函式 覆寫此行為。

語法

BOOL WlxStartApplication(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PVOID pEnvironment,
  [in] PWSTR pszCmdLine
);

[in] pWlxContext

與這個視窗月臺相關聯之 GINA 內容的指標。當 Winlogon 為此月臺呼叫 WlxInitialize 時，GINA 會傳回此內容值。

[in] pszDesktopName

指定要啟動應用程式的桌面名稱。透過 STARTUPINFO 結構的 lpDesktop 成員，將此字串傳遞至 CreateProcess 或 CreateProcessAsUser 函式。

[in] pEnvironment

指定進程的初始環境。 Winlogon 會建立此環境，並將其交給 GINA。 GINA 可以先修改此環境，再使用它來初始化使用者的殼層。當 GINA 使用此環境完成時，它必須呼叫 VirtualFree 函式來釋放配置給 pEnvironment 的記憶體。

[in] pszCmdLine

要執行的程式。

如果函式成功啟動應用程式，函式會傳回 TRUE。

如果函式失敗或應用程式未啟動，則函式會傳回 FALSE。

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

如果 GINA 未匯出 WlxStartApplication 函式，Winlogon 將會執行此程式。