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	Mbnapi.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

Kelas Sistem Operasi

Win32_SystemDriver