WESL_UserSetting.GetCustomShell
這個方法會根據 SID) 的安全識別符，擷取特定使用者或群組 (殼層啟動器設定。
語法
[Static] uint32 GetCustomShell (
[In, Required] string Sid,
[Out, Required] string Shell,
[Out, Required] sint32 CustomReturnCodes[],
[Out, Required] sint32 CustomReturnCodesAction[],
[Out, Required] sint32 DefaultAction
);
參數
Sid
[in， required]字串，其中包含設定Shell Launcher之使用者或群組的安全標識碼 (SID) 。
殼
[out， required]Shell Launcher 啟動為殼層的應用程式或可執行檔。
CustomReturnCodes
[out， required]殼層應用程式傳回的自定義傳回碼數位數組。
CustomReturnCodesAction
[out， required]自定義傳回碼動作的陣列，決定Shell Launcher在殼層應用程式結束時所採取的動作。 自定義動作會對應至 CustomReturnCodes 的陣列。
下表定義可能的動作：
| 值 | 說明 |
|---|---|
| 0 | 重新啟動殼層。 |
| 1 | 重新開機裝置。 |
| 2 | 關閉裝置。 |
| 3 | 什麼也不做。 |
DefaultAction
[out， required]殼層啟動器在殼層應用程式結束時所採取的默認動作。
下表定義可能的動作：
| 值 | 說明 |
|---|---|
| 0 | 重新啟動殼層。 |
| 1 | 重新開機裝置。 |
| 2 | 關閉裝置。 |
| 3 | 什麼也不做。 |
傳回值
傳回指出 WMI 狀態 或 WMI 錯誤的 HRESULT 值。
備註
Shell Launcher 會使用 CustomReturnCodes 和 CustomReturnCodesAction 數組，根據應用程式的傳回值，判斷殼層應用程式結束時的系統行為。
如果傳回值不存在於 CustomReturnCodes 中，或 CustomReturnCodesAction 中定義的對應動作不是有效的值，Shell Launcher 會使用 DefaultAction 來判斷系統行為。 如果未定義 DefaultAction 或不是有效的值，Shell Launcher 會重新啟動殼層應用程式。
需求
| Windows 版本 | 支援 |
|---|---|
| Windows 首頁 | 否 |
| Windows 專業版 | 否 |
| Windows 企業版 | 是 |
| Windows 教育版 | 是 |
| Windows IoT 企業版 | 是 |