WESL_UserSetting.GetCustomShell

  • Artikel

Diese Methode ruft die Konfiguration von Shell Launcher für einen bestimmten Benutzer oder eine bestimmte Gruppe ab, basierend auf dem Sicherheitsbezeichner (Security Identifier, SID).

Syntax

[Static] uint32 GetCustomShell (
    [In, Required] string Sid,
    [Out, Required] string Shell,
    [Out, Required] sint32 CustomReturnCodes[],
    [Out, Required] sint32 CustomReturnCodesAction[],
    [Out, Required] 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 ist.

Muschel
[out, erforderlich] Die Anwendung oder ausführbare Datei, die shell Launcher als Shell startet.

CustomReturnCodes
[out, erforderlich] Ein Array von benutzerdefinierten Rückgabecodes, die von der Shellanwendung zurückgegeben werden.

CustomReturnCodesAction
[out, erforderlich] 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
[out, erforderlich] 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 das CustomReturnCodes- und CustomReturnCodesAction-Array, um basierend auf dem Rückgabewert der Shellanwendung das Systemverhalten bei deren Beendigung zu bestimmen.

Wenn der Rückgabewert in CustomReturnCodes nicht 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