Bagikan melalui

Menambahkan Properti WMI

  • Artikel

Properti di kelas WMI menjelaskan data tentang objek terkelola. Misalnya, Handle, ProcessId, dan PageFaults didefinisikan sebagai properti dari kelas Win32_Process dan menjelaskan aspek dari proses sistem operasi. Untuk informasi selengkapnya, lihat Menulis Penyedia Properti.

Mendefinisikan Properti di MOF

Properti WMI mewakili aspek atau status dalam objek. Daripada membuat metode yang hanya mendapatkan dan menetapkan nilai, Anda dapat membuat properti. Misalnya, properti NetEnabledWin32_NetworkAdapter menampilkan apakah status adaptor diaktifkan atau dinonaktifkan. Namun, metode Aktifkan dan Nonaktifkan benar-benar melakukan tindakan mengubah status adaptor.

Sebuah properti harus memiliki tipe data. Jenis data properti Win32_ProcessHandle adalah string dan jenis data PageFaults uint32 . Jika properti hanya dapat memiliki dua status, jenis data properti biasanya diatur ke boolean.

Properti mungkin juga merupakan array. Misalnya, properti pengidentifikasi keamanan (SID) dari Win32_Trustee adalah array byte (uint8) yang berisi SID. Properti dapat berisi objek yang disematkan yang merupakan referensi ke satu atau beberapa instans kelas WMI lain. Daftar kontrol akses diskresi (DACL) dan daftar kontrol akses sistem (SACL) properti Win32_SecurityDescriptor, misalnya, adalah array objek Win32_ACE yang menjelaskan grup dan akun yang memiliki akses. Properti Grup di Win32_SecurityDescriptor berisi referensi ke sebuah instans Win32_Trustee. Untuk informasi selengkapnya, lihat Menyematkan Objek di Kelas.

Properti dapat memiliki beberapa kualifikasi . Kualifikasi ini mungkin Common Information Model (CIM) atau kualifikasi WMI atau mungkin khusus untuk jenis kelas tertentu, misalnya, kualifikasi kelas penghitung kinerja . Kualifikasi menentukan beberapa aspek properti, misalnya apakah bersifat hanya-baca atau tidak dapat diubah tanpa hak istimewa tertentu. Aplikasi yang mencoba menulis ke propertiDACL Win32_SecurityDescriptor, misalnya, memerlukan hak istimewa SeSecurityPrivilege dan SeRestorePrivilege. Untuk informasi selengkapnya, lihat Menambahkan Kualifikasi.

Akhirnya, properti harus memiliki nama. Anda dapat memberi nama properti apa pun dalam batas praktik pemrograman standar. Namun, ada dua pengecualian utama. Pertama, Anda tidak boleh menggunakan kata kunci MOF apa pun, seperti "kelas", sebagai nama properti. Kedua, Anda tidak boleh menggunakan kata kunci WQL apa pun, seperti "grup", sebagai nama properti juga. Untuk informasi selengkapnya tentang kata kunci MOF dan WQL, lihat Jenis Data MOF dan WQL (SQL untuk WMI).

Untuk kode C++ dan Managed Object Format (MOF), Anda mendeklarasikan properti sebuah kelas pada saat yang sama dengan deklarasi kelas tersebut.

Untuk menentukan properti

  • Sertakan jenis data properti, nama, dan nilai default opsional beserta kualifikasi di dalam kurung kurawal yang terdapat dalam deskripsi kelas.

    class MyClass 
{
    [key] string   strProp;
    sint32         dwProp1 = 21;
    uint32         dwProp2;
};

    Kelas MyClass dalam contoh sebelumnya memiliki tiga properti: string karakter, bilangan bulat bertanda tangan 32-bit, dan bilangan bulat yang tidak ditandatangani 32-bit. Setiap properti diberi nama yang tidak peka huruf besar/kecil dan jenis data MOF.

    Kualifikasi Key mendefinisikan properti string sebagai properti kunci yang secara unik mengidentifikasi instans kelas. Untuk informasi selengkapnya tentang kualifikasi, lihat Menambahkan kualifikasi.

Membuat Kelas