WESL_UserSetting.SetCustomShell

  • Artikel

Metode ini mengonfigurasi Shell Launcher untuk pengguna atau grup tertentu, berdasarkan pengidentifikasi keamanan (SID).

Sintaks

[Static] uint32 SetCustomShell (
    [In, Required] string Sid,
    [In, Required] string Shell,
    [In] sint32 CustomReturnCodes[],
    [In] sint32 CustomReturnCodesAction[],
    [In] sint32 DefaultAction
);

Parameter

Sid
[in, diperlukan] String yang berisi pengidentifikasi keamanan (SID) pengguna atau grup tempat Shell Launcher dikonfigurasi.

Shell
[in, diperlukan] Aplikasi atau executable yang Shell Launcher mulai sebagai shell.

CustomReturnCodes
[in] Array kode pengembalian kustom yang dapat dikembalikan oleh aplikasi shell.

CustomReturnCodesAction
[in] Array tindakan kode pengembalian kustom yang menentukan tindakan yang dilakukan Shell Launcher saat aplikasi shell keluar. Tindakan kustom memetakan ke array CustomReturnCodes.

Tindakan yang mungkin ditentukan dalam tabel berikut:

Nilai Deskripsi
0 Mulai ulang shell.
1 Mulai ulang perangkat.
2 Matikan perangkat.
3 Tidak melakukan apa pun.

DefaultAction
[In] Tindakan default yang dilakukan Shell Launcher ketika aplikasi shell keluar.

Tindakan yang mungkin ditentukan dalam tabel berikut:

Nilai Deskripsi
0 Mulai ulang shell.
1 Mulai ulang perangkat.
2 Matikan perangkat.
3 Tidak melakukan apa pun.

Tampilkan Nilai

Mengembalikan nilai HRESULT yang menunjukkan status WMI atau kesalahan WMI.

Keterangan

Shell Launcher menggunakan array CustomReturnCodes dan CustomReturnCodesAction untuk menentukan perilaku sistem saat aplikasi shell keluar, berdasarkan nilai pengembalian aplikasi shell.

Jika nilai yang dikembalikan tidak ada di CustomReturnCodes, atau jika tindakan terkait yang ditentukan dalam CustomReturnCodesAction bukan nilai yang valid, Shell Launcher menggunakan DefaultAction untuk menentukan perilaku sistem. Jika DefaultAction tidak ditentukan, atau bukan nilai yang valid, Shell Launcher memulai ulang aplikasi shell.

Persyaratan

Edisi Windows Didukung
Windows Home Tidak
Windows Pro Tidak
Windows Enterprise Ya
Windows Education Ya
Windows IoT Enterprise Ya