Metode IWbemServices::GetObject (wbemcli.h)

Artikel
08/27/2023

Metode IWbemServices::GetObject mengambil kelas atau instans. Metode ini hanya mengambil objek dari namespace yang terkait dengan objek IWbemServices saat ini.

Sintaks

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

Parameter

[in] strObjectPath

Jalur objek yang akan diambil. Jika ini ADALAH NULL, objek kosong dikembalikan yang dapat menjadi kelas baru. Untuk informasi selengkapnya, lihat Membuat Kelas.

[in] lFlags

Bendera berikut memengaruhi perilaku metode ini.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Jika bendera ini diatur, WMI mengambil kualifikasi yang diubah yang disimpan di namespace layanan lokal koneksi saat ini. Jika tidak diatur, hanya kualifikasi yang disimpan di namespace langsung yang diambil.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Bendera ini menjadikan ini panggilan sinkron.

WBEM_FLAG_RETURN_IMMEDIATELY

Bendera ini menjadikannya panggilan semisinkron. Anda harus menyediakan penunjuk yang valid untuk parameter ppCallResult . Untuk informasi selengkapnya, lihat Memanggil Metode.

WBEM_FLAG_DIRECT_READ

Bendera ini menyebabkan akses langsung ke penyedia untuk kelas yang ditentukan tanpa memperhatikan kelas atau subkelas induknya.

[in] pCtx

Biasanya NULL. Jika tidak, ini adalah penunjuk ke objek IWbemContext yang dapat digunakan oleh penyedia yang memproduksi kelas atau instans yang diminta. Nilai dalam objek konteks harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI.

[out] ppObject

Jika bukan NULL, ini menerima objek , jika ditemukan. Objek yang dikembalikan memiliki jumlah referensi positif. Pemanggil harus menggunakan Rilis ketika objek tidak lagi diperlukan. Dalam semua kasus kesalahan, parameter ini diatur untuk menunjuk ke NULL.

[out] ppCallResult

Jika NULL, parameter ini tidak digunakan. Jika parameter lFlags berisi WBEM_FLAG_RETURN_IMMEDIATELY, panggilan ini segera kembali dengan WBEM_S_NO_ERROR. Parameter ppCallResult menerima pointer ke objek IWbemCallResult baru, yang kemudian dapat dijajaki untuk mendapatkan hasilnya menggunakan metode GetCallStatus . Pemanggil dapat memanggil IWbemCallResult::GetResultObject untuk mengambil objek saat tersedia.

Mengembalikan nilai

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

Jika gagal, Anda dapat memperoleh informasi apa pun yang tersedia dari fungsi COM GetErrorInfo.

Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

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	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll