Kelas CInstance (instance.h)
[Kelas CInstance adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]
Kelas CInstance digunakan untuk mengambil dan memperbarui nilai properti yang ditentukan untuk instans yang didukung oleh WMI Provider Framework. Kelas CInstance juga menyediakan akses ke implementasi kerangka kerja penyedia antarmuka CInstance .
Tidak diharapkan bahwa penulis penyedia perlu berasal dari kelas ini. Gunakan Provider::CreateNewInstance untuk membuat instans kelas ini.
CInstance memiliki jenis anggota ini:
| Metode | Deskripsi |
|---|---|
| Menjalankan | Mengembalikan instans saat ini ke WMI. |
| Getbool | Mengambil properti Boolean. |
| GetByte | Mengambil properti yang kompatibel dengan BYTE. |
| GetCHString | Mengambil properti string. |
| GetClassObjectInterface | Mengembalikan penunjuk antarmuka IWbemClassObject . |
| GetDateTime | Mengembalikan properti datetime. |
| GetDOUBLE | Mengambil properti DOUBLE . |
| GetDWORD | Mengambil properti DWORD . |
| GetEmbeddedObject | Mengambil properti CInstance yang disematkan. |
| GetMethodContext | Mengembalikan penunjuk ke objek MethodContext . |
| GetStatus | Menentukan apakah properti ada dan, jika demikian, menentukan jenisnya. |
| GetStringArray | Mengambil properti yang mewakili array string. |
| GetTimeSpan | Mengambil properti yang mewakili rentang waktu WMI. |
| GetVariant | Mengambil properti VARIAN . |
| GetWBEMINT16 | Mengambil properti bilangan bulat 16-bit. |
| GetWBEMINT64 | Kelebihan beban. Mengambil properti bilangan bulat 64-bit. |
| GetWCHAR | Mengambil properti WCHAR . |
| GetWORD | Mengambil properti WORD . |
| IsNull | Menentukan apakah nilai properti tertentu adalah NULL. |
| Setbool | Mengatur properti Boolean . |
| SetByte | Mengatur properti BYTE . |
| SetCharSplat | Kelebihan beban. Mengatur properti string. |
| SetCHString | Kelebihan beban. Mengatur properti string. |
| SetDateTime | Mengatur properti tanggalwaktu. |
| SetDOUBLE | Mengatur properti DOUBLE . |
| SetDWORD | Mengatur properti DWORD . |
| SetEmbeddedObject | Mengatur properti CInstance yang disematkan. |
| SetNull | Mengatur properti ke NULL. |
| SetStringArray | Mengatur properti yang mewakili array string. |
| SetTimeSpan | Mengatur properti yang mewakili rentang waktu. |
| SetVariant | Mengatur properti VARIAN . |
| SetWBEMINT16 | Mengatur properti bilangan bulat 16-bit. |
| SetWBEMINT64 | Kelebihan beban. Mengatur properti bilangan bulat 64-bit. |
| SetWCHARSplat | Mengatur properti string WCHAR . |
| SetWORD | Mengatur properti WORD . |
Metode
Kelas CInstance memiliki metode ini.
| CInstance::Commit Metode Penerapan mengembalikan instans saat ini ke WMI. |
| CInstance::Getbool Metode Getbool mengambil properti Boolean. |
| CInstance::GetByte Metode GetByte mengambil properti yang kompatibel dengan BYTE. |
| CInstance::GetCHString Metode GetCHString mengambil properti string. |
| CInstance::GetClassObjectInterface Metode GetClassObjectInterface mengembalikan penunjuk antarmuka IWbemClassObject. |
| CInstance::GetDateTime Metode GetDateTime mengembalikan properti datetime. |
| CInstance::GetDOUBLE Metode GetDOUBLE mengambil properti DOUBLE. |
| CInstance::GetDWORD Metode GetDWORD mengambil properti DWORD. |
| CInstance::GetEmbeddedObject Metode GetEmbeddedObject mengambil penunjuk ke objek CInstance yang disematkan. Penunjuk dapat digunakan untuk mendapatkan dan mengatur properti objek yang disematkan tersebut. |
| CInstance::GetMethodContext Metode GetMethodContext mengembalikan penunjuk ke objek MethodContext. |
| CInstance::GetStatus Metode GetStatus menentukan apakah properti ada dan, jika demikian, menentukan jenisnya. |
| CInstance::GetStringArray Metode GetStringArray mengambil properti yang mewakili array string. |
| CInstance::GetTimeSpan Metode GetTimeSpan mengambil properti yang mewakili rentang waktu WMI. |
| CInstance::GetVariant Metode GetVariant mengambil properti VARIAN. |
| CInstance::GetWBEMINT16 Metode GetWBEMINT16 mengambil properti bilangan bulat 16-bit. |
| CInstance::GetWBEMINT64 Metode GetWBEMINT64 mengambil properti bilangan bulat 64-bit. (kelebihan beban 1/3) |
| CInstance::GetWBEMINT64 Metode GetWBEMINT64 mengambil properti bilangan bulat 64-bit. (kelebihan beban 3/3) |
| CInstance::GetWBEMINT64 Metode GetWBEMINT64 mengambil properti bilangan bulat 64-bit. (kelebihan beban 2/3) |
| CInstance::GetWCHAR Metode GetWCHAR mengambil properti string WCHAR. |
| CInstance::GetWORD Metode GetWORD mengambil properti WORD. |
| CInstance::IsNull Metode IsNull menentukan apakah nilai properti tertentu adalah NULL. |
| CInstance::Setbool Metode Setbool menetapkan properti Boolean. |
| CInstance::SetByte Metode SetByte mengatur properti BYTE. |
| CInstance::SetCharSplat Metode SetCharSplat(LPCWSTR, DWORD) menetapkan string. |
| CInstance::SetCharSplat Metode SetCharSplat(LPCWSTR, LPCSTR) menetapkan properti string. |
| CInstance::SetCharSplat Metode SetCharSplat(LPCWSTR, LPCWSTR) menetapkan properti string. |
| CInstance::SetCHString Metode SetCHString(LPCWSTR, const CHString&) menetapkan properti string. (kelebihan beban 2/2) |
| CInstance::SetCHString Metode SetCHString(LPCWSTR, LPCSTR) menetapkan properti string. |
| CInstance::SetCHString Metode SetCHString(LPCWSTR, const CHString&) menetapkan properti string. (kelebihan beban 1/2) |
| CInstance::SetDateTime Metode SetDateTime menetapkan properti tanggalwaktu. |
| CInstance::SetDOUBLE Metode CInstance::SetDOUBLE |
| CInstance::SetDWORD Metode SetDWORD menetapkan properti DWORD. |
| CInstance::SetEmbeddedObject Metode SetEmbeddedObject menetapkan properti CInstance yang disematkan. |
| CInstance::SetNull Metode SetNull mengatur properti ke NULL. |
| CInstance::SetStringArray Metode SetStringArray mengatur properti yang mewakili array string. |
| CInstance::SetTimeSpan Metode SetTimeSpan mengatur properti yang mewakili rentang waktu. |
| CInstance::SetVariant Metode SetVariant mengatur properti VARIAN. |
| CInstance::SetWBEMINT16 Metode SetWBEMINT16 menetapkan properti bilangan bulat 16-bit. |
| CInstance::SetWBEMINT64 Metode SetWBEMINT64(LPCWSTR, const LONGLONG&) menetapkan nilai bilangan bulat 64-bit. (kelebihan beban 3/3) |
| CInstance::SetWBEMINT64 Metode SetWBEMINT64(LPCWSTR, const LONGLONG&) menetapkan nilai bilangan bulat 64-bit. (kelebihan beban 1/3) |
| CInstance::SetWBEMINT64 Metode SetWBEMINT64(LPCWSTR, const LONGLONG&) menetapkan nilai bilangan bulat 64-bit. (kelebihan beban 2/3) |
| CInstance::SetWCHARSplat Metode SetWCHARSplat mengatur properti string. |
| CInstance::SetWORD Metode SetWORD mengatur properti WORD. |
Keterangan
Destruktor untuk kelas ini adalah CInstance::~CInstance.
Metode kelas CInstance digunakan untuk mengambil dan mengatur nilai properti. Jenis data properti didefinisikan menggunakan jenis data CIM yang dapat dilihat dalam file .mof. Saat mengkueri atau mengatur nilai properti menggunakan metode CInstance , perlu menggunakan metode yang kompatibel dengan jenis data CIM properti. Tabel berikut mencantumkan jenis data CIM dan CInstance yang diizinkan mendapatkan atau mengatur metode untuk mengakses properti jenis data tersebut.
| Jenis data CIM | Jenis metode CInstance Get/Set |
|---|---|
| string |
VARIAN WCHAR CharSplat |
| sint8 | VARIAN |
| uint8 | BYTE |
| sint16 |
WBEMINT16 VARIAN |
| uint16 |
WORD DWORD VARIAN |
| sint32 |
WORD DWORD VARIAN |
| uint32 |
WORD DWORD VARIAN |
| sint64 |
VARIAN WBEMINT64 WCHAR |
| uint64 |
VARIAN WBEMINT64 WCHAR |
| real32 | VARIAN |
| real64 |
DOUBLE VARIAN |
| char16 | VARIAN |
| DateTime |
DateTime VARIAN WCHAR |
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | instance.h (termasuk FwCommon.h) |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk