次の方法で共有

WESL_UserSetting.SetCustomShell

このメソッドは、セキュリティ識別子 (SID) に基づいて、特定のユーザーまたはグループのシェル起動ツールを構成します。

Windows エディションの要件

次の一覧には、シェル起動ツールをサポートする Windows エディションが含まれています。

✅ Enterprise /Enterprise LTSC
✅ Education
✅ IoT Enterprise / IoT Enterprise LTSC

構文

[Static] uint32 SetCustomShell (
    [In, Required] string Sid,
    [In, Required] string Shell,
    [In] sint32 CustomReturnCodes[],
    [In] sint32 CustomReturnCodesAction[],
    [In] sint32 DefaultAction
);

パラメーター

Sid
[入力、必須]シェル起動ツールが構成されているユーザーまたはグループのセキュリティ識別子 (SID) を含む文字列。

Shell
[入力、必須]シェル起動ツールがシェルとして起動するアプリケーションまたは実行可能ファイル。

CustomReturnCodes
[in]シェル アプリケーションから返すことができるカスタム戻りコードの配列。

CustomReturnCodesAction
[in]シェル アプリケーションの終了時にシェル起動ツールが実行するアクションを決定するカスタムリターンコードアクションの配列。 カスタム アクションは CustomReturnCodes の配列にマップされます。

考えられるアクションは、次の表で定義されています。

値 説明
0 シェルを再起動します。
1 デバイスを再起動します。
2 デバイスをシャットダウンします。
3 何もしない。

DefaultAction
[入力]シェル アプリケーションが終了したときにシェル起動ツールが実行する既定のアクション。

考えられるアクションは、次の表で定義されています。

値 説明
0 シェルを再起動します。
1 デバイスを再起動します。
2 デバイスをシャットダウンします。
3 何もしない。

戻り値

WMI の状態または WMI エラーを示す HRESULT 値を返します。

注釈

シェル 起動ツールでは、 CustomReturnCodes 配列と CustomReturnCodesAction 配列を使用して、シェル アプリケーションの戻り値に基づいて、シェル アプリケーションが終了したときのシステム動作を判断します。

戻り値が CustomReturnCodes に存在しない場合、または CustomReturnCodesAction で定義されている対応するアクションが有効な値でない場合、シェル起動ツールは DefaultAction を 使用してシステム動作を判断します。 DefaultAction が定義されていない場合、または有効な値でない場合は、シェル 起動ツールによってシェル アプリケーションが再起動されます。

  • Last updated on