Membuat metode dari kelas Win32_BaseService

Artikel
06/03/2023

Metode Buatkelas WMI membuat layanan baru. Parameter LoadOrderGroup mewakili pengelompokan layanan sistem yang menentukan dependensi eksekusi. Layanan harus dimulai dalam urutan yang ditentukan oleh Grup Urutan Beban, karena layanan bergantung satu sama lain. Layanan dependen ini mengharuskan kehadiran 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 Create(
  [in] string  Name,
  [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

Nama [in]

Nama layanan yang akan diinstal ke metode Buat . Panjang string maksimum adalah 256 karakter. Database manajer kontrol layanan mempertahankan kasus karakter, tetapi perbandingan nama layanan selalu tidak peka huruf besar/kecil. Garis miring maju (/) dan garis miring kembali ganda (\) adalah karakter nama layanan yang tidak valid.

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. Nilainya adalah bitmap.

Driver Kernel (1)

Driver Sistem File (2)

Adaptor (4)

Driver Recognizer (8)

Proses Sendiri (16)

Proses Berbagi (32)

256

Proses Interaktif

ErrorControl [in]

Tingkat keparahan kesalahan jika metode Buat gagal dimulai. Nilai menunjukkan tindakan yang diambil oleh program startup jika kegagalan terjadi. Semua kesalahan dicatat oleh sistem.

Abaikan (0)

Pengguna tidak diberi tahu.

Normal (1)

Pengguna diberi tahu.

Parah (2)

Sistem dimulai ulang dengan konfigurasi terakhir yang diketahui baik.

Kritis (3)

Sistem mencoba untuk memulai dengan konfigurasi yang baik.

StartMode [in]

Mode mulai layanan dasar Windows.

Boot Start ("Boot")

Driver perangkat dimulai oleh pemuat sistem operasi. Nilai ini hanya berlaku untuk layanan driver.

System Start ("System")

Driver perangkat dimulai oleh proses inisialisasi sistem operasi. Nilai ini hanya berlaku untuk layanan driver.

Mulai Otomatis ("Otomatis")

Layanan yang akan dimulai secara otomatis oleh manajer kontrol layanan selama startup sistem.

Permintaan Mulai ("Manual")

Layanan yang akan dimulai oleh manajer kontrol layanan saat proses memanggil metode StartService .

Dinonaktifkan ("Dinonaktifkan")

Layanan yang tidak dapat lagi dimulai.

DesktopInteract [in]

Jika true, layanan dapat membuat atau berkomunikasi dengan windows di desktop.

StartName [in]

Nama akun tempat layanan berjalan. Bergantung pada jenis layanan, nama akun mungkin dalam bentuk "DomainName\Username". Proses layanan dicatat menggunakan salah satu dari dua formulir ini saat berjalan. Jika akun milik domain bawaan, ".\Username" dapat ditentukan. Jika NULL ditentukan, layanan masuk sebagai akun LocalSystem. Untuk driver tingkat kernel atau sistem, StartName berisi nama objek driver (yaitu, \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 oleh sistem I/O berdasarkan nama layanan. Contoh: DWDOM\Admin.

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.

LoadOrderGroup [in]

Nama grup yang terkait dengan layanan baru. Grup pesanan beban terkandung dalam registri, dan menentukan urutan di mana layanan dimuat ke dalam sistem operasi. Jika pointer adalah 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 urutan beban, diikuti oleh layanan yang bukan milik grup. Registri memiliki daftar grup pemesanan beban yang terletak di:

\ HKEY_LOCAL_MACHINE Sistem\CurrentControlSet\Kontrol\ServiceGroupOrder

LoadOrderGroupDependencies [in]

Array grup pengurutan beban yang harus dimulai sebelum layanan ini. Setiap item dalam array dibatasi oleh NULL dan daftar dihentikan oleh dua nilai NULL . Di Visual Basic atau skrip, Anda dapat meneruskan vbArray. Jika pointer adalah NULL atau jika menunjuk ke string kosong, layanan tidak memiliki dependensi. Nama grup harus diawali dengan karakter SC_GROUP_IDENTIFIER (didefinisikan 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]

Array yang berisi nama layanan yang harus dimulai sebelum layanan ini dimulai. Setiap item dalam array dibatasi oleh NULL dan daftar dihentikan oleh dua nilai NULL . Di Visual Basic atau skrip, Anda dapat meneruskan vbArray. Jika pointer adalah 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.

Nilai kembali

Mengembalikan salah satu nilai yang tercantum dalam daftar berikut ini atau nilai lainnya untuk menunjukkan kesalahan.

Berhasil

Permintaan diterima.

Tidak Didukung

Permintaan tidak didukung.

Akses Ditolak

Pengguna tidak memiliki akses yang diperlukan.

Layanan Dependen Berjalan

Layanan tidak dapat dihentikan karena layanan lain yang sedang berjalan bergantung padanya.

Kontrol Layanan Tidak Valid

Kode kontrol yang diminta tidak valid, atau tidak dapat diterima oleh layanan.

Layanan Tidak Dapat Menerima Kontrol

Kode kontrol yang diminta tidak dapat dikirim ke layanan karena status layanan (Win32_BaseService. Properti status) sama dengan 0, 1, atau 2.

Layanan Tidak Aktif

Layanan belum dimulai.

Waktu Permintaan Layanan Habis

Layanan ini tidak menanggapi permintaan mulai secara tepat waktu.

Kegagalan Tidak Diketahui

Proses interaktif.

Jalur Tidak Ditemukan

Jalur direktori ke file yang dapat dieksekusi layanan tidak ditemukan.

Layanan Sudah Berjalan

Layanan sudah berjalan.

Database Layanan Terkunci

Database untuk menambahkan layanan baru dikunci.

Dependensi Layanan Dihapus

Dependensi di mana layanan ini bergantung telah dihapus dari sistem.

Kegagalan Dependensi Layanan

Layanan gagal menemukan layanan yang diperlukan dari layanan dependen.

Layanan Dinonaktifkan

Layanan telah dinonaktifkan dari sistem.

Log Masuk Layanan Gagal

Layanan tidak memiliki autentikasi yang benar untuk dijalankan pada sistem.

Layanan ditandai untuk penghapusan

Layanan ini sedang dihapus dari sistem.

Layanan Tanpa Utas

Tidak ada utas eksekusi untuk layanan.

Dependensi Sirkuler Status

Ada dependensi melingkar saat memulai layanan.

Nama Duplikat Status

Ada layanan yang berjalan dengan nama yang sama.

Nama Status Tidak Valid

Ada karakter yang tidak valid dalam nama layanan.

Parameter Status Tidak Valid

Parameter yang tidak valid telah diteruskan ke layanan.

Status Akun Layanan Tidak Valid

Akun tempat layanan ini dijalankan tidak valid atau tidak memiliki izin untuk menjalankan layanan.

Layanan Status Ada

Layanan ada dalam database layanan yang tersedia dari sistem.

Layanan Sudah Dijeda

Layanan saat ini dijeda dalam sistem.

Lainnya

25 4294967295

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

Kelas Sistem Operasi
Win32_BaseService

Bagikan melalui