PWLX_ASSIGN_SHELL_PROTECTION コールバック関数 (winwlx.h)

  • [アーティクル]

[WlxAssignShellProtection 関数は、Windows Server 2008 および Windows Vista では使用できなくなりました。

新しくログオンしたユーザーのシェル プログラムに保護を割り当てるために GINA によって呼び出されます。

メモ Windows Vista では GINA DLL は無視されます。
 
シェル プロセスを中断状態で作成してから、シェル プロセスに適切な保護を適用するために WlxAssignShellProtection 関数を呼び出す必要があります。

この関数は、Windows API CreateProcessAsUser 関数に置き換えられます。

構文

PWLX_ASSIGN_SHELL_PROTECTION PwlxAssignShellProtection;

int PwlxAssignShellProtection(
  [in] HANDLE hWlx,
  [in] HANDLE hToken,
  [in] HANDLE hProcess,
  [in] HANDLE hThread
)
{...}

パラメーター

[in] hWlx

WlxInitialize 呼び出しで GINA に渡される Winlogon ハンドルを指定します。

[in] hToken

プライマリ トークンへのハンドルを指定します。

[in] hProcess

変更するプロセスへのハンドルを指定します。 プロセスは中断状態で作成する必要があります。これは、 PROCESS_INFORMATION 構造体で返されるハンドルである必要があります。

[in] hThread

プロセスの初期スレッドへのハンドルを指定します。

戻り値

WlxAssignShellProtection 関数は、保護の割り当て中に発生したすべてのエラーを返します。

注釈

Windows API CreateProcessAsUser 関数は 、WlxAssignShellProtection よりも優先されます。 WlxActivateUserShell で CreateProcessAsUser を呼び出して、シェル プロセスを作成し、その保護を 1 回の呼び出しで設定します。

要件

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

こちらもご覧ください

CreateProcessAsUser

WlxActivateUserShell

WlxInitialize