ホーム › Security.WinWlx › PWLX_ASSIGN_SHELL_PROTECTION

PWLX_ASSIGN_SHELL_PROTECTION

コールバック

シグネチャ

INT PWLX_ASSIGN_SHELL_PROTECTION(
    HANDLE hWlx,
    HANDLE hToken,
    HANDLE hProcess,
    HANDLE hThread
);

パラメーター

フィールド	型	説明
hWlx	HANDLE	WlxInitialize の呼び出しで GINA に渡された Winlogon ハンドルを指定します。
hToken	HANDLE	プライマリトークンのハンドルを指定します。
hProcess	HANDLE	変更対象のプロセスのハンドルを指定します。プロセスは中断状態で作成されている必要があり、 PROCESS_INFORMATION 構造体で返されたハンドルを指定します。
hThread	HANDLE	プロセスの初期スレッドのハンドルを指定します。

公式ドキュメント

[WlxAssignShellProtection 関数は、Windows Server 2008 および Windows Vista 以降では使用できません。]

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

注 GINA DLL は Windows Vista では無視されます。

シェルプロセスは中断状態で作成し、その後に WlxAssignShellProtection 関数を呼び出して、シェルプロセスへ適切な保護を適用してください。

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

戻り値

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

解説(Remarks)

Windows API の CreateProcessAsUser 関数は、WlxAssignShellProtection に取って代わるものです。 WlxActivateUserShell 内で CreateProcessAsUser を呼び出すと、シェルプロセスの作成とその保護の設定を 1 回の呼び出しで行えます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)