WESL_UserSetting.SetCustomShell
Diese Methode konfiguriert Shell Launcher für einen bestimmten Benutzer oder eine bestimmte Gruppe basierend auf der Sicherheits-ID (SID).
Syntax
[Static] uint32 SetCustomShell (
[In, Required] string Sid,
[In, Required] string Shell,
[In] sint32 CustomReturnCodes[],
[In] sint32 CustomReturnCodesAction[],
[In] sint32 DefaultAction
);
Parameter
Sid
[in, erforderlich] Eine Zeichenfolge, die die Sicherheits-ID (SID) des Benutzers oder der Gruppe enthält, für den das Shell-Startprogramm konfiguriert wird.
Muschel
[in, erforderlich] Die Anwendung oder ausführbare Datei, die shell Launcher als Shell startet.
CustomReturnCodes
[in] Ein Array von benutzerdefinierten Rückgabecodes, die von der Shellanwendung zurückgegeben werden können.
CustomReturnCodesAction
[in] Ein Array von benutzerdefinierten Rückgabecodeaktionen, die die Aktion bestimmen, die shell Launcher ausführt, wenn die Shellanwendung beendet wird. Die benutzerdefinierten Aktionen werden dem Array von CustomReturnCodes zugeordnet.
Die möglichen Aktionen sind in der folgenden Tabelle definiert:
Wert | BESCHREIBUNG |
---|---|
0 | Starten Sie die Shell neu. |
1 | Starten Sie das Gerät neu. |
2 | Fahren Sie das Gerät herunter. |
3 | Sie unternehmen nichts. |
Defaultaction
[In] Die Standardaktion, die shell Launcher ausführt, wenn die Shellanwendung beendet wird.
Die möglichen Aktionen sind in der folgenden Tabelle definiert:
Wert | BESCHREIBUNG |
---|---|
0 | Starten Sie die Shell neu. |
1 | Starten Sie das Gerät neu. |
2 | Fahren Sie das Gerät herunter. |
3 | Sie unternehmen nichts. |
Rückgabewert
Gibt einen HRESULT - Wert zurück, der den WMI - Status oder einen WMI - Fehler angibt.
Bemerkungen
Shell Launcher verwendet die Arrays CustomReturnCodes und CustomReturnCodesAction, um das Systemverhalten beim Beenden der Shell-Anwendung basierend auf dem Rückgabewert der Shell-Anwendung zu bestimmen.
Wenn der Rückgabewert nicht in CustomReturnCodes vorhanden ist oder wenn die entsprechende Aktion, die in CustomReturnCodesAction definiert ist, kein gültiger Wert ist, verwendet Shell Launcher DefaultAction, um das Systemverhalten zu bestimmen. Wenn DefaultAction nicht definiert oder kein gültiger Wert ist, startet Shell Launcher die Shell-Anwendung neu.
Anforderungen
Windows-Edition | Unterstützt |
---|---|
Windows Home | Nein |
Windows Pro | Nein |
Windows Enterprise | Ja |
Windows Education | Ja |
Windows IoT Enterprise | Ja |