Fungsi GetObjectText

Mengembalikan perenderan tekstual objek dalam sintaks Managed Object Format (MOF).

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

HRESULT GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

lFlags
[in] Biasanya 0. Jika WBEM_FLAG_NO_FLAVORS (atau 0x1) ditentukan, kualifikasi disertakan tanpa informasi penyebaran atau rasa.

pstrObjectText [out] Penunjuk ke null pada entri. Saat kembali, BSTR yang baru dialokasikan yang berisi perenderan sintaks MOF objek.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus	Nilai	Deskripsi
WBEM_E_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_OUT_OF_MEMORY	0x80041006	Memori tidak cukup tersedia untuk menyelesaikan operasi.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::GetObjectText.

Teks MOF yang dikembalikan tidak berisi semua informasi tentang objek, tetapi hanya informasi yang cukup untuk pengompilasi MOF untuk dapat membuat ulang objek asli. Misalnya, tidak ada kualifikasi yang disebarkan atau properti kelas induk yang disertakan.

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] digabungkan menjadi satu parameter.

pstrObjectText harus menjadi penunjuk ke null saat fungsi dipanggil; tidak boleh menunjuk ke string yang valid sebelum panggilan metode, karena penunjuk tidak akan dibatalkan alokasinya.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)