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:

1. Parameter diurutkan kembali dalam urutan nilai pengidentifikasinya.
2. 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

Lihat juga

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE