WESL_UserSetting.SetCustomShell

  • Artikel

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