Freigeben über

WESL_UserSetting.SetCustomShell

Diese Methode konfiguriert das Shell-Startprogramm 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 das Shell-Startprogramm 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 das Shell-Startprogramm 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 keine Aktion ausführen.

DefaultAction
[In] Die Standardaktion, die das Shell-Startprogramm 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 keine Aktion ausführen.

Rückgabewert

Gibt einen HRESULT-Wert zurück, der WMI-status oder einen WMI-Fehler angibt.

Hinweise

Das Shell-Startprogramm verwendet die Arrays CustomReturnCodes und CustomReturnCodesAction , um das Systemverhalten beim Beenden der Shellanwendung basierend auf dem Rückgabewert der Shellanwendung zu bestimmen.

Wenn der Rückgabewert in CustomReturnCodes nicht vorhanden ist oder die entsprechende in CustomReturnCodesAction definierte Aktion kein gültiger Wert ist, verwendet das Shell-Startprogramm DefaultAction , um das Systemverhalten zu bestimmen. Wenn DefaultAction nicht definiert ist oder kein gültiger Wert ist, startet das Shell-Startprogramm die Shellanwendung neu.

Anforderungen

Windows-Edition Unterstützt
Windows Home Nein
Windows Pro Nein
Windows Enterprise Ja
Windows Education Ja
Windows IoT Enterprise Ja