WlxStartApplication 関数 (winwlx.h)

  • [アーティクル]

[WlxStartApplication 関数は、Windows Server 2008 および Windows Vista の時点で使用できなくなりました。]

WlxStartApplication 関数は、代替の GINA DLL によって実装できます。 Winlogon は 、ユーザーの コンテキスト でアプリケーションを起動する必要がある場合に、この関数を呼び出します。

ユーザーのコンテキストで起動するアプリケーションがシステムに必要になる理由は 2 つあります。

  • Windows エクスプローラーが予期せず終了し、再起動する必要があります。
  • 拡張タスク マネージャーを実行する必要があります。
メモ 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 デスクトップになるようにデスクトップの状態を設定し、デスクトップがロックされるようにワークステーションの状態を設定します。

WlxStartApplication 関数が GINA によってエクスポートされない場合、Winlogon はプロセスを実行します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winwlx.h

こちらもご覧ください

WlxInitialize