Metode SetSecurityDescriptor dari kelas Win32_Service (Penyedia CIMWin32 WMI)
Metode SetSecurityDescriptor menulis versi terbaru deskriptor keamanan yang mengontrol akses ke layanan.
Sintaks
uint32 SetSecurityDescriptor(
[in] Win32_SecurityDescriptor Descriptor
);
Parameter
-
Deskriptor [in]
-
Deskriptor keamanan yang terkait dengan layanan.
Nilai kembali
Mengembalikan salah satu nilai yang tercantum dalam daftar berikut ini, atau nilai yang berbeda untuk menunjukkan kesalahan. Untuk kode kesalahan tambahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
-
Berhasil
-
0
Permintaan diterima.
-
1
-
Permintaan tidak didukung.
-
Akses ditolak
-
2
Pengguna tidak memiliki akses yang diperlukan.
-
3
-
Layanan tidak dapat dihentikan karena layanan lain yang sedang berjalan bergantung padanya.
-
4
-
Kode kontrol yang diminta tidak valid, atau tidak dapat diterima oleh layanan.
-
5
-
Kode kontrol yang diminta tidak dapat dikirim ke layanan karena status layanan (Win32_BaseService. Properti status) sama dengan 0, 1, atau 2.
-
6
-
Layanan belum dimulai.
-
7
-
Layanan ini tidak menanggapi permintaan mulai secara tepat waktu.
-
Kegagalan tidak diketahui
-
8
Kegagalan tidak diketahui saat memulai layanan.
-
Hak istimewa hilang
-
9
Jalur direktori ke file yang dapat dieksekusi layanan tidak ditemukan.
-
10
-
Layanan sudah berjalan.
-
11
-
Database untuk menambahkan layanan baru dikunci.
-
12
-
Dependensi yang diandalkan layanan ini telah dihapus dari sistem.
-
13
-
Layanan gagal menemukan layanan yang diperlukan dari layanan dependen.
-
14
-
Layanan telah dinonaktifkan dari sistem.
-
15
-
Layanan tidak memiliki autentikasi yang benar untuk dijalankan pada sistem.
-
16
-
Layanan ini sedang dihapus dari sistem.
-
17
-
Layanan ini tidak memiliki utas eksekusi.
-
18
-
Layanan ini memiliki dependensi melingkar ketika dimulai.
-
19
-
Layanan berjalan dengan nama yang sama.
-
20
-
Nama layanan memiliki karakter yang tidak valid.
-
Parameter tidak valid
-
21
Parameter yang tidak valid telah diteruskan ke layanan.
-
22
-
Akun tempat layanan ini berjalan tidak valid atau tidak memiliki izin untuk menjalankan layanan.
-
23
-
Layanan ada dalam database layanan yang tersedia dari sistem.
-
24
-
Layanan saat ini dijeda dalam sistem.
-
Lainnya
-
22 4294967295
Keterangan
Instans Win32_SecurityDescriptor mewakili jenis data SECURITY_DESCRIPTOR_CONTROL dan berisi daftar kontrol akses diskresi (DACL) dan daftar kontrol akses sistem (SACL). Untuk informasi selengkapnya, lihat Daftar Access Control.
Jika SeSecurityPrivilege tidak diberikan atau diaktifkan saat mendapatkan deskriptor keamanan, maka hanya DACL yang dikembalikan dalam deskriptor keamanan yang dikembalikan. Untuk informasi selengkapnya, lihat Konstanta Hak Istimewa dan Menjalankan Operasi Istimewa.
Anda dapat memperbarui DACL dan SACL dalam instans Win32_SecurityDescriptor saat memanggil metode ini, tetapi Anda juga hanya dapat memperbarui DACL atau hanya SACL.
Nilai berikut dalam SECURITY_DESCRIPTOR_CONTROL menentukan apakah DACL, SACL, atau keduanya diperbarui.
SE_DACL_PRESENT
Menunjukkan bahwa DACL harus diperbarui. Jika ini tidak diatur, maka WMI mempertahankan nilai asli DACL.
SE_SACL_PRESENT
Menunjukkan bahwa SACL harus diperbarui. Jika ini tidak diatur, maka WMI mempertahankan nilai asli SACL. Untuk memperbarui SACL, akun harus mengaktifkan hak istimewa SeSecurityPrivilege . Untuk pembuatan skrip, nama hak istimewanya adalah SeSecurityPrivilege. Untuk informasi selengkapnya, lihat Konstanta Hak Istimewa.
Jika properti Wali kepercayaan Grup dan pemilik bukan NULL, maka mereka diperbarui. Jika tidak, WMI mempertahankan nilai asli. Untuk informasi selengkapnya, lihat Objek Deskriptor Keamanan WMI.
Ketika SACL baru adalah NULL dalam panggilan metode ini, maka deskriptor keamanan SACL pada objek yang dapat diamankan target dibiarkan tidak berubah.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Ruang nama |
Root\CIMV2 |
MOF |
|
DLL |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk