WESL_UserSetting.SetCustomShell

Articolo
03/11/2025
Si applica a:

✅ Windows 11, ✅ Windows 10

Questo metodo configura l'utilità di avvio della shell per un utente o un gruppo specifico, in base all'identificatore di sicurezza (SID).

Requisiti dell'edizione di Windows

L'elenco seguente contiene le edizioni di Windows che supportano Shell Launcher:

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

Sintassi

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

Parametri

Sid
[in, obbligatorio] Stringa contenente l'identificatore di sicurezza (SID) dell'utente o del gruppo per cui è in corso la configurazione dell'utilità di avvio della shell.

Shell
[in, obbligatorio] Applicazione o eseguibile avviato da Shell Launcher come shell.

CustomReturnCodes
[in] Matrice di codici restituiti personalizzati che possono essere restituiti dall'applicazione shell.

CustomReturnCodesAction
[in] Matrice di azioni di codice restituite personalizzate che determinano l'azione eseguita dall'utilità di avvio della shell quando l'applicazione shell viene chiusa. Le azioni personalizzate eseguono il mapping alla matrice di CustomReturnCodes.

Le azioni possibili sono definite nella tabella seguente:

Value	Descrizione
0	Riavviare la shell.
1	Riavvia il dispositivo.
2	Arrestare il dispositivo.
3	Non fare nulla.

DefaultAction
[In] Azione predefinita eseguita dall'utilità di avvio della shell quando l'applicazione shell viene chiusa.

Le azioni possibili sono definite nella tabella seguente:

Value	Descrizione
0	Riavviare la shell.
1	Riavvia il dispositivo.
2	Arrestare il dispositivo.
3	Non fare nulla.

Valore restituito

Restituisce un valore HRESULT che indica lo stato WMI o un errore WMI.

Osservazioni

Shell Launcher usa le matrici CustomReturnCodes e CustomReturnCodesAction per determinare il comportamento del sistema all'uscita dell'applicazione shell, in base al valore restituito dell'applicazione shell.

Se il valore restituito non esiste in CustomReturnCodes o se l'azione corrispondente definita in CustomReturnCodesAction non è un valore valido, Shell Launcher usa DefaultAction per determinare il comportamento del sistema. Se DefaultAction non è definito o non è un valore valido, Shell Launcher riavvia l'applicazione shell.

Condividi tramite