Freigeben über


WESL_UserSetting.SetDefaultShell

Diese Methode legt die Standardkonfiguration des Shell-Startprogramms fest.

Anforderungen an die Windows-Edition

Die folgende Liste enthält die Windows-Editionen, die das Shell-Startprogramm unterstützen:

✅ Enterprise/Enterprise LTSC
✅ Education
✅ IoT Enterprise / IoT Enterprise LTSC

Syntax

[Static] uint32 SetDefaultShell (
    [In, Required] string Shell,
    [In, Required] sint32 DefaultAction
);

Parameter

Shell
[in, erforderlich] Die Anwendung oder ausführbare Datei, die das Shell-Startprogramm als Shell startet.

DefaultAction
[in, erforderlich] 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 Standardkonfiguration, wenn die Sicherheits-ID (SID) des aktuell angemeldeten Benutzers nicht mit benutzerdefinierten Shell-Startprogrammkonfigurationen übereinstimmt.