Metode IWbemObjectTextSrc::GetText (wbemcli.h)

Metode IWbemObjectTextSrc::GetText membuat representasi tekstual objek IWbemClassObject ; misalnya, representasi XML.

Sintaks

HRESULT GetText(
  long             lFlags,
  IWbemClassObject *pObj,
  ULONG            uObjTextFormat,
  IWbemContext     *pCtx,
  BSTR             *strText
);

Parameter

lFlags

Dicadangkan. Harus 0L.

pObj

Referensi ke objek yang akan diwakili dalam format teks. Parameter ini tidak boleh NULL.

uObjTextFormat

Definisi format teks yang digunakan untuk mewakili objek. Untuk informasi selengkapnya tentang nilai yang valid untuk parameter ini, lihat Keterangan.

WMI_OBJ_TEXT_CIM_DTD_2_0 (1 (0x1))

Gunakan DTD yang sesuai dengan CIM DTD versi 2.0.

WMI_OBJ_TEXT_WMI_DTD_2_0 (2 (0x2))

Gunakan WMI DTD yang sesuai dengan CIM DTD versi 2.0. Menggunakan nilai ini memungkinkan ekstensi khusus WMI, seperti objek atau cakupan yang disematkan.

WMI_OBJ_TEXT_WMI_EXT1 (3 (0x3))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT2 (4 (0x4))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT3 (5 (0x5))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT4 (6 (0x6))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT5 (7 (0x7))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT6 (8 (0x8))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT7 (9 (0x9))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT8 (10 (0xA))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT9 (11 (0xB))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_WMI_EXT10 (12 (0xC))

Disiapkan untuk penggunaan masa mendatang.

WMI_OBJ_TEXT_LAST (13 (0xD))

Disiapkan untuk penggunaan masa mendatang.

pCtx

Opsional. Objek konteks untuk operasi. Objek konteks dapat digunakan untuk menentukan apakah bagian tertentu dari objek diwakili dalam teks; misalnya, apakah akan menyertakan kualifikasi dalam representasi tekstual. Objek konteks mengambil nilai opsional berikut.

LocalOnly (VT_BOOL)

Jika TRUE, hanya properti dan metode yang ditentukan secara lokal yang ada dalam XML yang dihasilkan. Defaultnya adalah FALSE.

IncludeQualifiers (VT_BOOL)

Jika TRUE, kualifikasi kelas, instans, properti, dan metode disertakan dalam output. Defaultnya adalah FALSE.

PathLevel (VT_I4)

Defaultnya adalah 0 (nol).

Potensi nilai:

• 0

  Elemen CLASS atau INSTANCE dibuat tergantung pada apakah objek tersebut adalah kelas atau instans.

• 1

  NILAI. Elemen NAMEDOBJECT dihasilkan.

• 2

  NILAI. Elemen OBJECTWITHLOCALPATH dihasilkan.

• 3

  NILAI. Elemen OBJECTWITHPATH dihasilkan.

ExcludeSystemProperties (VT_BOOL)

Jika TRUE, properti sistem, seperti __NAMESPACE, tidak ada dalam output. Defaultnya adalah FALSE.

SertakanClassOrigin (VT_BOOL)

Jika TRUE, atribut asal kelas diatur pada elemen PROPERTY dan METHOD . Defaultnya adalah FALSE.

strText

Representasi tekstual objek. Pengguna harus membebaskan string menggunakan SysFreeString setelah selesai dengan strText.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Keterangan

Untuk informasi selengkapnya, lihat Mewakili Objek di XML.

Persyaratan

Persyaratan	Nilai
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	Fastprox.dll