kelas __Win32Provider

  • Artikel

Kelas sistem __Win32Provider mendaftarkan informasi tentang implementasi fisik penyedia di WMI. Penyedia yang tidak mengatur properti HostingModel dimuat, secara default, untuk berjalan dalam proses Wmiprvse.exe sebagai NetworkServiceHostOrSelfHost.

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

Sintaks

class __Win32Provider : __Provider
{
  string   ClientLoadableCLSID;
  string   CLSID;
  sint32   Concurrency;
  string   DefaultMachineName;
  boolean  Enabled;
  string   HostingModel;
  sint32   ImpersonationLevel = 0;
  sint32   InitializationReentrancy;
  datetime InitializationTimeoutInterval;
  boolean  InitializeAsAdminFirst;
  string   Name;
  datetime OperationTimeoutInterval;
  boolean  PerLocaleInitialization = FALSE;
  boolean  PerUserInitialization = FALSE;
  boolean  Pure = TRUE;
  string   SecurityDescriptor;
  boolean  SupportsExplicitShutdown;
  boolean  SupportsExtendedStatus;
  boolean  SupportsQuotas;
  boolean  SupportsSendStatus;
  boolean  SupportsShutdown;
  boolean  SupportsThrottling;
  datetime UnloadTimeout;
  uint32   Version;
};

Anggota

Kelas __Win32Provider memiliki jenis anggota ini:

Properti

Kelas __Win32Provider memiliki properti ini.

ClientLoadableCLSID

Jenis data: string

Jenis akses: Baca/tulis

Pengidentifikasi kelas yang digunakan WMI untuk menentukan apakah akan memuat penyedia performa tinggi ke dalam proses klien atau proses WMI atau tidak. Jika penyedia dan klien terletak di komputer yang sama, WMI memuat penyedia dalam proses ke klien dengan menggunakan ClientLoadableCLSID sebagai pengidentifikasi kelas. Ketika penyedia dan klien terletak di komputer yang berbeda, WMI memuat penyedia dalam proses ke WMI. WMI juga menggunakan ClientLoadableCLSID untuk mendukung operasi refresh.

Untuk informasi selengkapnya, lihat Mendaftarkan Penyedia High-Performance.

CLSID

Jenis data: string

Jenis akses: Baca/tulis

GUID yang mewakili pengidentifikasi kelas (CLSID) dari objek COM penyedia. Objek COM ini harus berisi implementasi antarmuka IWbemProviderInit .

Konkurensi

Jenis data: sint32

Jenis akses: Baca/tulis

Tidak digunakan.

DefaultMachineName

Jenis data: string

Jenis akses: Baca/tulis

Mengidentifikasi komputer untuk memulai penyedia. Jika penyedia berjalan pada komputer lokal, artinya NULL.

Aktif

Jenis data: boolean

Jenis akses: Baca/tulis

Jika TRUE, instans ini diaktifkan dan dapat digunakan untuk menyelesaikan permintaan klien.

HostingModel

Jenis data: string

Jenis akses: Baca/tulis

Properti ini terdiri dari nilai dari properti MSFT_ProvidersHostingGroup dan HostingSpecification . Nilai properti ini menentukan bagaimana WMI memuat penyedia dan akun keamanan yang dijalankannya. Untuk informasi selengkapnya tentang mengatur properti HostingModel , lihat Penyedia Hosting dan Keamanan dan Mendaftarkan Penyedia.

ImpersonationLevel

Jenis data: sint32

Jenis akses: Baca/tulis

Dicadangkan. Nilai defaultnya adalah nol (0).

InitializationReentrancy

Jenis data: sint32

Jenis akses: Baca/tulis

Kumpulan bendera yang menyediakan informasi tentang serialisasi. Nilai defaultnya adalah nol (0).

0

Semua inisialisasi penyedia ini harus diserialisasikan.

1

Semua inisialisasi penyedia ini di namespace yang sama harus diserialisasikan.

2

Tidak diperlukan serialisasi inisialisasi.

InitializationTimeoutInterval

Jenis data: tanggalwaktu

Jenis akses: Baca/tulis

Tidak digunakan.

InitializeAsAdminFirst

Jenis data: boolean

Jenis akses: Baca/tulis

TBD

Nama

Jenis data: string

Jenis akses: Baca/tulis

Kualifikasi: Kunci

Nama penyedia.

OperationTimeoutInterval

Jenis data: tanggalwaktu

Jenis akses: Baca/tulis

Tidak digunakan.

PerLocaleInitialization

Jenis data: boolean

Jenis akses: Baca/tulis

Jika TRUE, penyedia diinisialisasi untuk setiap lokal saat pengguna terhubung ke namespace yang sama lebih dari satu kali menggunakan lokal yang berbeda. Nilai defaultnya adalah FALSE.

PerUserInitialization

Jenis data: boolean

Jenis akses: Baca/tulis

Jika TRUE, penyedia diinisialisasi satu kali untuk setiap pengguna NT LAN Manager (NTLM) yang membuat permintaan ke penyedia. Jika FALSE (default), penyedia diinisialisasi satu kali untuk semua pengguna.

Pure

Jenis data: boolean

Jenis akses: Baca/tulis

Jika TRUE, penyedia setuju untuk bersiap untuk membongkar dengan memanggil IUnknown::Release pada semua titik antarmuka yang luar biasa ketika WMI memanggil metode Rilis antarmuka utamanya. Penyedia yang harus tetap menjadi klien WMI setelah tidak berfungsi sebagai penyedia harus mengatur Murni ke FALSE. Pengaturan defaultnya adalah TRUE. Untuk informasi selengkapnya, lihat bagian Keterangan dari topik ini.

SecurityDescriptor

Jenis data: string

Jenis akses: Baca/tulis

Pendeskripsi keamanan (SD) dalam Security Descriptor Definition Language (SDDL) yang menentukan kumpulan pengguna yang berhasil memanggil IWbemDecoupledRegistrar:Register untuk penyedia yang dipisahkan. Untuk informasi selengkapnya, lihat topik Bahasa Definisi Deskriptor Keamanan di bagian Keamanan Windows SDK. Deskriptor keamanan ini hanya digunakan untuk penyedia yang di-decouple, dan tidak memengaruhi penyedia lain. Untuk informasi selengkapnya, lihat Menggabungkan Penyedia dalam Aplikasi.

WMI melakukan pemeriksaan akses untuk penyedia yang dipecah yang menggunakan antarmuka IWbemProviderInit dan IWbemObjectSink . Jika deskriptor keamanan NULL, maka hanya aplikasi atau layanan yang berjalan di bawah akun LocalSystem, NetworkService, LocalService yang dapat menjalankan penyedia yang didekop.

String berikut menunjukkan penyedia yang dipisahkan untuk dijalankan hanya oleh Administrator bawaan." O:BAG:BAD:(A;;0 x1;;; BA)"

Untuk informasi selengkapnya tentang mengatur properti SecurityDescriptor , lihat Mempertahankan Keamanan WMI.

MendukungExplicitShutdown

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

SupportsExtendedStatus

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

MendukungQuotas

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

SupportsSendStatus

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

MendukungShutdown

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

MendukungThrottling

Jenis data: boolean

Jenis akses: Baca/tulis

Tidak digunakan.

UnloadTimeout

Jenis data: tanggalwaktu

Jenis akses: Baca/tulis

Format Tanggal dan Waktu yang menentukan berapa lama WMI memungkinkan penyedia untuk tetap menganggur sebelum dibongkar. Biasanya, penyedia meminta WMI menunggu tidak lebih dari lima menit.

Untuk versi WMI saat ini, nilai properti ini diabaikan. WMI membongkar penyedia berdasarkan nilai waktu habis di kelas internal di namespace \root. Disarankan agar penyedia mengatur UnloadTimeout. Untuk informasi selengkapnya, lihat Membongkar Penyedia.

Versi

Jenis data: uint32

Jenis akses: Baca/tulis

Versi penyedia. Versi yang didukung adalah 1 dan 2. Versi 2 memperkuat pemeriksaan validitas untuk semua pendaftaran properti terkait, khususnya properti ImpersonationLevel .

Keterangan

Kelas __Win32Provider berasal dari __Provider.

Sebagian besar penyedia dapat menerima nilai default untuk properti InitializationReentrancy . Namun, jika penyedia dapat mendukung inisialisasi simultan untuk pengguna terpisah, properti ini dapat diatur ke 1 (satu). Jika inisialisasi berseri diperlukan, InitializationReentrancy tetap 0 (nol). Dalam kedua instans, PerUserInitialization diatur ke TRUE.

Penyedia murni atau penyedia yang mengatur properti Murni ke TRUE, hanya ada untuk permintaan layanan dari aplikasi dan WMI. Sebagian besar penyedia adalah penyedia murni. Penyedia nonpure adalah pengecualian. Penyedia nonpure beralih ke peran klien setelah mereka menyelesaikan permintaan layanan.

Contoh penyedia nonpure adalah penyedia push yang mulai mengeluarkan kueri, dan membuat permintaan WMI setelah menyelesaikan inisialisasi. Penyedia push tidak memiliki tanggung jawab kecuali untuk memperbarui repositori CIM dengan data pada waktu inisialisasi. Setelah memperbarui repositori, penyedia pendorongan dapat menunggu untuk dibongkar, atau beralih ke peran klien. Penyedia push yang menunggu untuk dibongkar adalah penyedia murni. Penyedia pendorongan yang berpartisipasi dalam aktivitas klien bersifat nonpure.

WMI harus dapat membedakan penyedia murni dari penyedia non-murni sehingga dapat menentukan kapan aman untuk dimatikan. WMI harus menunggu semua operasi yang melibatkan penyedia non-murni selesai sebelum dapat dimatikan dengan aman.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista
Server minimum yang didukung
 Windows Server 2008
Ruang nama
 Semua namespace layanan WMI

Lihat juga

__Penyedia

Kelas Sistem WMI

Mendaftarkan Penyedia