WlxStartApplication 関数 (winwlx.h)
[WlxStartApplication 関数は、Windows Server 2008 および Windows Vista の時点で使用できなくなりました。]
WlxStartApplication 関数は、代替の GINA DLL によって実装できます。 Winlogon は 、ユーザーの コンテキスト でアプリケーションを起動する必要がある場合に、この関数を呼び出します。
ユーザーのコンテキストで起動するアプリケーションがシステムに必要になる理由は 2 つあります。
- Windows エクスプローラーが予期せず終了し、再起動する必要があります。
- 拡張タスク マネージャーを実行する必要があります。
構文
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 デスクトップになるようにデスクトップの状態を設定し、デスクトップがロックされるようにワークステーションの状態を設定します。
WlxStartApplication 関数が GINA によってエクスポートされない場合、Winlogon はプロセスを実行します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | winwlx.h |