Mengubah metode kelas Win32_SystemDriver
Metode kelas UbahWMI memodifikasi layanan Win32_SystemDriver . Parameter Win32_LoadOrderGroup mewakili pengelompokan layanan sistem yang menentukan dependensi eksekusi. Layanan harus dimulai dalam urutan yang ditentukan oleh Grup Pesanan Beban karena layanan bergantung satu sama lain. Layanan dependen ini mengharuskan keberadaan layanan antecedent berfungsi dengan benar.
Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 Change(
[in] string DisplayName,
[in] string PathName,
[in] uint8 ServiceType,
[in] uint8 ErrorControl,
[in] string StartMode,
[in] boolean DesktopInteract,
[in] string StartName,
[in] string StartPassword,
[in] string LoadOrderGroup,
[in] string LoadOrderGroupDependencies[],
[in] string ServiceDependencies[]
);
Parameter
-
DisplayName [in]
-
Nama tampilan layanan. String ini memiliki panjang maksimum 256 karakter. Nama ini dipertahankan huruf besar/kecil di manajer kontrol layanan. Perbandingan DisplayName selalu tidak peka huruf besar/kecil.
Batasan: Menerima nilai yang sama dengan parameter Nama .
Contoh: "Atdisk"
-
PathName [in]
-
Jalur yang sepenuhnya memenuhi syarat ke file yang dapat dieksekusi yang mengimplementasikan layanan.
Contoh: \SystemRoot\System32\drivers\afd.sys
-
ServiceType [in]
-
Jenis layanan yang disediakan untuk proses yang memanggilnya.
-
1 (0x1)
-
Kernel Driver
-
2 (0x2)
-
Driver Sistem File
-
4 (0x4)
-
Adaptor
-
8 (0x8)
-
Recognizer Driver
-
16 (0x10)
-
Proses Sendiri
-
32 (0x20)
-
Proses Berbagi
-
256 (0x100)
-
Proses Interaktif
ErrorControl [in]
Tingkat keparahan kesalahan jika layanan ini gagal dimulai selama startup. Nilai menunjukkan tindakan yang diambil oleh program startup jika kegagalan terjadi. Semua kesalahan dicatat oleh sistem.
Abaikan (0)
Pengguna tidak diberi tahu.
Normal (1)
Normal. Pengguna diberi tahu.
Parah (2)
Sistem dimulai ulang dengan konfigurasi terakhir yang baik.
Kritis (3)
Sistem mencoba untuk memulai ulang dengan konfigurasi yang baik.
StartMode [in]
Mode awal layanan dasar Windows.
Mulai Boot
Driver perangkat dimulai oleh pemuat sistem operasi.
Mulai Boot
Driver perangkat yang dimulai oleh pemuat sistem operasi.
Mulai Sistem
Driver perangkat dimulai oleh proses inisialisasi sistem operasi. Nilai ini hanya berlaku untuk layanan driver.
Mulai Otomatis
Layanan untuk memulai secara otomatis oleh manajer kontrol layanan selama startup sistem.
Permintaan Mulai
Layanan untuk dimulai oleh manajer kontrol layanan saat proses memanggil metode StartService .
Tamu penyandang cacat
Layanan yang tidak dapat dimulai.
DesktopInteract [in]
Nilai yang, jika True, layanan dapat membuat atau berkomunikasi dengan jendela di desktop.
StartName [in]
Nama akun tempat layanan berjalan. Bergantung pada jenis layanan, nama akun mungkin dalam bentuk DomainName\Username atau .\Username. Ketika berjalan, proses layanan dicatat menggunakan salah satu dari dua bentuk ini. Jika akun milik domain bawaan, .\Nama pengguna dapat ditentukan. Jika string kosong ditentukan, layanan akan masuk sebagai akun LocalSystem. Untuk driver tingkat kernel atau sistem, StartName berisi nama objek driver, misalnya, \FileSystem\Rdr atau \Driver\Xns), yang digunakan sistem input dan output (I/O) untuk memuat driver perangkat. Jika NULL ditentukan, driver berjalan dengan nama objek default yang dibuat sistem I/O berdasarkan nama layanan, misalnya, DWDOM\Admin.
Anda juga dapat menggunakan format Nama Prinsipal Pengguna (UPN) untuk menentukan StartName, misalnya, Username@DomainName.
StartPassword [in]
Kata sandi ke nama akun yang ditentukan oleh parameter StartName . Tentukan NULL jika Anda tidak mengubah kata sandi. Tentukan string kosong jika layanan tidak memiliki kata sandi.
Catatan
Saat mengubah layanan dari sistem lokal ke jaringan, atau dari jaringan ke sistem lokal, StartPassword harus berupa string kosong ("") dan bukan NULL.
LoadOrderGroup [in]
Nama grup yang terkait dengannya. Grup urutan beban terkandung dalam registri sistem, dan menentukan urutan di mana layanan dimuat ke dalam sistem operasi. Jika penunjuk NULL, atau jika menunjuk ke string kosong, layanan bukan milik grup. Dependensi antar grup harus tercantum dalam parameter LoadOrderGroupDependencies . Layanan dalam daftar grup pengurutan beban dimulai terlebih dahulu, diikuti oleh layanan dalam grup yang tidak ada dalam daftar grup pengurutan beban, diikuti oleh layanan yang bukan milik grup. Registri sistem memiliki daftar grup pengurutan beban yang terletak di:
\ HKEY_LOCAL_MACHINE Sistem\CurrentControlSet\Kontrol\ServiceGroupOrder
LoadOrderGroupDependencies [in]
Daftar grup pengurutan beban yang harus dimulai sebelum layanan ini dimulai. Array dihentikan dua kali lipat null. Jika penunjuk NULL, atau jika menunjuk ke string kosong, layanan tidak memiliki dependensi. Nama grup harus diawali oleh karakter SC_GROUP_IDENTIFIER (ditentukan dalam file WinSvc.h) untuk membedakannya dari nama layanan, karena layanan dan grup layanan memiliki namespace layanan yang sama. Dependensi pada grup berarti bahwa layanan ini dapat berjalan jika setidaknya satu anggota grup berjalan setelah upaya untuk memulai semua anggota grup.
ServiceDependencies [in]
Daftar yang berisi nama layanan yang harus dimulai sebelum layanan ini dimulai. Array dihentikan dua kali lipat null. Jika penunjuk NULL, atau jika menunjuk ke string kosong, layanan tidak memiliki dependensi. Dependensi pada layanan berarti bahwa layanan ini hanya dapat berjalan jika layanan yang bergantung padanya berjalan.
Mengembalikan nilai
Mengembalikan nilai nol (0) jika layanan berhasil dimodifikasi, 1 (satu) jika permintaan tidak didukung, dan angka lain untuk menunjukkan kesalahan.
-
Sukses (0)
-
Tidak Didukung (1)
-
Akses Ditolak (2)
-
Layanan Dependen Berjalan (3)
-
Kontrol Layanan Tidak Valid (4)
-
Layanan Tidak Dapat Menerima Kontrol (5)
-
Layanan Tidak Aktif (6)
-
Batas Waktu Permintaan Layanan (7)
-
Kegagalan Tidak Diketahui (8)
-
Jalur Tidak Ditemukan (9)
-
Layanan Sudah Berjalan (10)
-
Database Layanan Terkunci (11)
-
Dependensi Layanan Dihapus (12)
-
Kegagalan Dependensi Layanan (13)
-
Layanan Dinonaktifkan (14)
-
Log Masuk Layanan Gagal (15)
-
Layanan ditandai untuk penghapusan (16)
-
Layanan Tanpa Utas (17)
-
Dependensi Sirkular Status (18)
-
Nama Duplikat Status (19)
-
Nama Status Tidak Valid (20)
-
Parameter Status Tidak Valid (21)
-
Status Akun Layanan Tidak Valid (22)
-
Layanan Status Ada (23)
-
Layanan Sudah Dijeda (24)
-
Lainnya (25 4294967295)
Keterangan
Untuk mengubah layanan dari layanan jaringan ke sistem lokal, gunakan nilai berikut untuk parameter StartName dan StartPassword :
StartName = "LocalSystem"
StartPassword = "" // - empty string, not NULL
Untuk mengubah layanan dari layanan sistem lokal ke layanan jaringan, gunakan nilai berikut untuk parameter StartName dan StartPassword :
StartName = "NT AUTHORITY\NetworkService"
StartPassword = "" // - empty string, not NULL
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista |
| Server minimum yang didukung |
Windows Server 2008 |
| Ruang nama |
Root\CIMV2 |
| Header |
|
| MOF |
|
| DLL |
|