kelas Win32_BaseService

Artikel
06/12/2023

Kelas WMI abstrak Win32_BaseService mewakili objek yang dapat dieksekusi yang diinstal dalam database registri yang dikelola oleh Service Control Manager. File yang dapat dieksekusi yang terkait dengan layanan dapat dimulai pada waktu boot oleh program boot atau oleh sistem. Ini juga dapat dimulai sesuai permintaan oleh Service Control Manager. Layanan atau proses apa pun yang tidak dimiliki oleh pengguna tertentu, dan yang menyediakan antarmuka untuk beberapa fungsionalitas yang didukung oleh sistem komputer, adalah turunan (atau anggota) dari kelas ini.

Contoh: Layanan klien protokol konfigurasi host dinamis (DHCP) pada sistem komputer yang menjalankan Windows Server.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Anggota

Kelas Win32_BaseService memiliki jenis anggota ini:

Metode
Properti

Metode

Kelas Win32_BaseService memiliki metode ini.

Metode	Deskripsi
Perubahan	Memodifikasi layanan.
ChangeStartMode	Memodifikasi mode mulai layanan.
Buat	Membuat layanan baru.
Hapus	Menghapus layanan yang sudah ada.
InterrogateService	Meminta agar layanan memperbarui statusnya ke manajer layanan.
PauseService	Upaya untuk menempatkan layanan dalam status dijeda.
ResumeService	Mencoba menempatkan layanan dalam status dilanjutkan.
StartService	Mencoba menempatkan layanan ke status startup-nya.
StopService	Metode kelas yang menempatkan layanan dalam status berhenti.
UserControlService	Mencoba mengirim kode kontrol yang ditentukan pengguna ke layanan.

Properti

Kelas Win32_BaseService memiliki properti ini.

AcceptPause

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Layanan Menerima Jeda")

Layanan dapat dijeda.

AcceptStop

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Layanan Menerima Berhenti")

Layanan dapat dihentikan.

Keterangan

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi singkat objek .

Properti ini diwarisi dari CIM_ManagedSystemElement.

CreationClassName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: CIM_Key, DisplayName ("Nama Kelas")

Nama kelas konkret pertama yang muncul dalam rantai pewarisan yang digunakan dalam pembuatan instans. Ketika digunakan dengan properti kunci kelas lainnya, properti memungkinkan semua instans kelas ini dan subkelasnya diidentifikasi secara unik.

Properti ini diwarisi dari CIM_Service.

Deskripsi

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Deskripsi")

Deskripsi objek .

Properti ini diwarisi dari CIM_ManagedSystemElement.

DesktopInteract

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Berinteraksi Dengan Desktop")

Layanan dapat membuat atau berkomunikasi dengan windows di desktop.

DisplayName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nama Tampilan")

Nama tampilan layanan. String ini memiliki panjang maksimum 256 karakter. Nama ini dipertahankan huruf besar/kecil di Service Control Manager. Perbandingan DisplayName selalu tidak peka huruf besar/kecil.

Batasan: Menerima nilai yang sama dengan properti Nama .

Contoh: "Atdisk"

ErrorControl

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Tingkat Keparahan Kegagalan Startup")

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

Abaikan ("Abaikan")

Pengguna tidak diberi tahu.

Normal ("Normal")

Pengguna diberi tahu.

Parah ("Parah")

Sistem dimulai ulang dengan konfigurasi terakhir yang diketahui baik.

Kritis ("Kritis")

Sistem mencoba untuk memulai ulang dengan konfigurasi yang baik.

Tidak diketahui ("Tidak Diketahui")

Tindakan yang diambil tidak ditentukan.

ExitCode

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Kode Keluar")

Menentukan masalah apa pun yang dihadapi dalam memulai atau menghentikan layanan. Properti ini diatur ke ERROR_SERVICE_SPECIFIC_ERROR (1066) ketika kesalahan unik untuk layanan yang diwakili oleh kelas ini, dan informasi tentang kesalahan tersedia di properti ServiceSpecificExitCode . Layanan menetapkan nilai ini ke NO_ERROR saat berjalan, dan sekali lagi setelah penghentian normal.

InstallDate

Jenis data: tanggalwaktu
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Objek telah diinstal. Properti ini tidak memerlukan nilai untuk menunjukkan bahwa objek diinstal.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nama

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Kunci

Pengidentifikasi unik layanan, yang memberikan indikasi fungsionalitas yang dikelola. Fungsionalitas ini dijelaskan secara lebih rinci di properti Deskripsi objek.

Properti ini diwarisi dari CIM_ManagedSystemElement.

PathName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nama Jalur File")

Jalur yang sepenuhnya memenuhi syarat ke file biner layanan yang mengimplementasikan layanan.

Contoh: "\SystemRoot\System32\drivers\afd.sys"

ServiceSpecificExitCode

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Kode Keluar Khusus Server")

Kode kesalahan khusus layanan untuk kesalahan yang terjadi saat layanan dimulai atau dihentikan. Kode keluar ditentukan oleh layanan yang diwakili oleh kelas ini. Nilai ini hanya diatur ketika nilai ExitCodepropertyERROR_SERVICE_SPECIFIC_ERROR (1066).

ServiceType

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Jenis Layanan")

Layanan yang disediakan untuk proses panggilan.

Driver Kernel ("Driver Kernel")

Driver Sistem File ("Driver Sistem File")

Adapter ("Adapter")

Driver Recognizer ("Driver Recognizer")

Proses Sendiri ("Proses Sendiri")

Proses Berbagi ("Proses Berbagi")

Proses Interaktif ("Proses Interaktif")

Dimulai

Jenis data: boolean
Jenis akses: Baca-saja
Kualifikasi: DisplayName ("Started")

Layanan telah dimulai.

Properti ini diwarisi dari CIM_Service.

StartMode

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Mengambil alih ("StartMode"), DisplayName ("Mode Mulai")

Mode mulai layanan dasar Windows.

Properti ini diwarisi dari CIM_Service.

Boot ("Boot")

Driver perangkat dimulai oleh pemuat sistem operasi (hanya berlaku untuk layanan driver).

Sistem ("Sistem")

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

Otomatis ("Otomatis")

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

Manual ("Manual")

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

Dinonaktifkan ("Dinonaktifkan")

Layanan yang tidak dapat lagi dimulai.

StartName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nama Akun Awal")

Nama akun tempat layanan berjalan. Bergantung pada jenis layanan, nama akun mungkin dalam bentuk "DomainName\Username" atau format UPN (Username@DomainName). Proses layanan akan dicatat menggunakan salah satu dari dua formulir ini saat berjalan. Jika akun milik domain bawaan, ".\Username" dapat ditentukan. Jika NULL ditentukan, layanan akan 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. Selain itu, jika NULL ditentukan, driver berjalan dengan nama objek default yang dibuat oleh sistem I/O berdasarkan nama layanan. Contoh: "DWDOM\Admin".

Provinsi

Jenis data: string
Jenis akses: Baca/tulis
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Status layanan dasar saat ini.

Dihentikan ("Dihentikan")

Mulai Tertunda ("Mulai Tertunda")

Berhenti Tertunda ("Berhenti Tertunda")

Menjalankan ("Berjalan")

Lanjutkan Tertunda ("Lanjutkan Tertunda")

Jeda Tertunda ("Jeda Tertunda")

Dijeda ("Dijeda")

Tidak diketahui ("Tidak Diketahui")

Windows Server 2008 dan Windows Vista: Properti ini bersifat baca-saja.

Status

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: MaxLen (10), DisplayName ("Status")

Status objek saat ini. Berbagai status operasional dan nonoperasional dapat ditentukan. Status operasional meliputi: "OK", "Degraded", dan "Pred Fail" (elemen, seperti hard disk drive berkemampuan SMART, mungkin berfungsi dengan baik tetapi memprediksi kegagalan dalam waktu dekat). Status nonoperational meliputi: "Error", "Starting", "Stopping", dan "Service". Yang terakhir, "Layanan", dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, namun elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nilai yang valid mencakup sebagai berikut:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Lost Comm ("Lost Comm")

SystemCreationClassName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nama Kelas Sistem")

Ketik nama sistem yang menghosting layanan ini.

Properti ini diwarisi dari CIM_Service.

SystemName

Jenis data: string
Jenis akses: Baca-saja
Kualifikasi: Disebarluaskan ("CIM_System. Nama"), CIM_Key, DisplayName ("Nama Sistem")

Nama sistem yang menghosting layanan ini.

Properti ini diwarisi dari CIM_Service.

TagId

Jenis data: uint32
Jenis akses: Baca-saja
Kualifikasi: MappingStrings ("Win32API| Struktur Layanan| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Id Tag")

Nilai tag unik untuk layanan ini dalam grup. Nilai 0 (nol) menunjukkan bahwa layanan belum diberi tag. Tag dapat digunakan untuk memesan layanan star tup dalam grup urutan beban dengan menentukan vektor pesanan tag di registri yang terletak di: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. Tag hanya dievaluasi untuk layanan jenis mulai Driver Kernel dan Driver Sistem File yang memiliki mode Boot atau System start.

Keterangan

Kelas Win32_BaseService berasal dari CIM_Service.

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

CIM_Service
Kelas Sistem Operasi

Bagikan melalui

kelas Win32_BaseService

Sintaks

Anggota

Metode

Properti

Keterangan

Persyaratan

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: