Metode IWbemClassObject::GetObjectText (wbemcli.h)
Metode IWbemClassObject::GetObjectText mengembalikan penyajian tekstual objek dalam sintaks MOF. Perhatikan bahwa teks MOF yang dikembalikan tidak berisi semua informasi tentang objek, tetapi hanya informasi yang cukup untuk pengkompilasi MOF untuk dapat membuat ulang objek asli. Misalnya, tidak ada kualifikasi yang disebarkan atau properti kelas induk yang ditampilkan.
Sintaks
HRESULT GetObjectText(
[in] long lFlags,
[out] BSTR *pstrObjectText
);
Parameter
[in] lFlags
Biasanya 0. Jika WBEM_FLAG_NO_FLAVORS ditentukan, kualifikasi akan disajikan tanpa informasi penyebaran atau rasa.
[out] pstrObjectText
Ini harus menunjuk ke NULL pada entri. Parameter ini menerima dari Manajemen Windows BSTR yang baru dialokasikan yang diinisialisasi dengan SysAllocString. Anda harus memanggil SysFreeString pada pointer saat string tidak lagi diperlukan. Penunjuk ini menunjuk ke penyajian sintaks MOF objek saat kembali dari panggilan. Karena ini adalah parameter keluar, penunjuk tidak boleh menunjuk ke string yang valid sebelum metode ini dipanggil, karena penunjuk tidak akan dibatalkan alokasinya.
Mengembalikan nilai
Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
Keterangan
Algoritma berikut digunakan untuk merekonstruksi teks parameter suatu metode:
- Parameter diurutkan kembali dalam urutan nilai pengidentifikasinya.
- Parameter yang ditentukan sebagai [in] dan [out] akan digabungkan menjadi satu parameter.
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | wbemcli.h (termasuk Wbemidl.h) |
| Pustaka | WbemUuid.lib |
| DLL | CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll |