WESL_UserSetting.SetCustomShell
Questo metodo configura l'utilità di avvio della shell per un utente o un gruppo specifico, in base all'identificatore di sicurezza (SID).
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.
Guscio
[in, obbligatorio] Applicazione o eseguibile avviata da Shell Launcher come shell.
CustomReturnCodes
[in] Matrice di codici restituiti personalizzati che possono essere restituiti dall'applicazione shell.
CustomReturnCodesAction
[in] Matrice di azioni del codice restituito personalizzate che determinano l'azione eseguita da Avvio shell all'uscita dall'applicazione shell. Le azioni personalizzate eseguono il mapping alla matrice di CustomReturnCodes.
Le azioni possibili sono definite nella tabella seguente:
Valore | Descrizione |
---|---|
0 | Riavviare la shell. |
1 | Riavviare il dispositivo. |
2 | Arrestare il dispositivo. |
3 | Non eseguire alcuna operazione. |
Defaultaction
[In] Azione predefinita eseguita da Avvio shell all'uscita dall'applicazione shell.
Le azioni possibili sono definite nella tabella seguente:
Valore | Descrizione |
---|---|
0 | Riavviare la shell. |
1 | Riavviare il dispositivo. |
2 | Arrestare il dispositivo. |
3 | Non eseguire alcuna operazione. |
Valore restituito
Restituisce un valore HRESULT che indica lo stato WMI o un errore WMI.
Commenti
Shell Launcher usa le matrici CustomReturnCodes e CustomReturnCodesAction per determinare il comportamento di sistema quando l'applicazione shell viene chiusa, 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, Avvio shell usa DefaultAction per determinare il comportamento del sistema. Se DefaultAction non è definito o non è un valore valido, Launcher shell riavvia l'applicazione shell.
Requisiti
Edizione per Windows | Supportato |
---|---|
Windows Home | No |
Windows Pro | No |
Windows Enterprise | Sì |
Windows Education | Sì |
Windows IoT Enterprise | Sì |