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
);
參數
希
[in, required]字串,包含殼層啟動器所設定之使用者或群組 (SID) 的安全性識別碼。
殼
[out, required]Shell 啟動器啟動作為殼層的應用程式或可執行檔。
CustomReturnCodes
[out, required]殼層應用程式傳回的自訂傳回碼陣列。
CustomReturnCodesAction
[out, required]自訂傳回碼動作的陣列,決定 Shell 啟動器在殼層應用程式結束時所採取的動作。 自訂動作會對應至 CustomReturnCodes的陣列。
下表定義了可能的動作:
值 | 描述 |
---|---|
0 | 重新開機殼層。 |
1 | 重新啟動裝置。 |
2 | 關閉裝置。 |
3 | 不執行任何動作。 |
DefaultAction
[out, required]Shell 啟動器在殼層應用程式結束時所採取的預設動作。
下表定義了可能的動作:
值 | 描述 |
---|---|
0 | 重新開機殼層。 |
1 | 重新啟動裝置。 |
2 | 關閉裝置。 |
3 | 不執行任何動作。 |
傳回值
傳回 HRESULT 值,指出 WMI 狀態 或 WMI 錯誤。
備註
Shell 啟動器會根據應用程式的傳回值,使用 CustomReturnCodes 和 CustomReturnCodesAction 陣列來判斷殼層應用程式結束時的系統行為。
如果 CustomReturnCodes中不存在傳回值,或 如果 CustomReturnCodesAction 中定義的對應動作不是有效的值,Shell Launcher 會使用 DefaultAction 來判斷系統行為。 如果未定義 DefaultAction ,或不是有效的值,Shell 啟動器會重新開機殼層應用程式。
規格需求
Windows 版本 | 支援 |
---|---|
Windows 首頁 | No |
Windows 專業版 | 否 |
Windows 企業版 | 是 |
Windows 教育版 | 是 |
Windows IoT 企業版 | 是的 |