CWbemProviderGlue::GetInstanceByPath (wbemglue.h)

Artikel
03/13/2024

[Kelas CWbemProviderGlue adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode GetInstanceByPath mengambil instans yang diidentifikasi oleh jalur objek tertentu dengan memanggil metode GetObject penyedia.

Sintaks

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parameter

pszObjectPath

Jalur objek ke instans yang akan dikembalikan.

ppInstance

Pointer ke pointer ke instans CInstance yang digunakan untuk menyimpan instans baru. Penyedia kerangka kerja yang melakukan permintaan harus merilis pointer ini.

pMethodContext

Penunjuk ke konteks saat ini. Konteks harus disediakan untuk mencegah kebuntuan. Gunakan konteks yang diteruskan ke penyedia oleh Penyedia::EnumerateInstances atau Provider::ExecQuery, atau dapatkan dari instans menggunakan CInstance::GetMethodContext. Parameter ini tidak boleh NULL.

Nilai kembali

Mengembalikan WBEM_S_NO_ERROR jika operasi berhasil, WBEM_E_OUT_OF_MEMORY jika operasi gagal karena kurangnya memori, atau kode kesalahan HRESULT lainnya.

Keterangan

Metode GetInstanceByPath memungkinkan penyedia kerangka kerja mengakses data dari penyedia lain tanpa memerlukan panggilan API WMI. Penyedia kerangka kerja meneruskan jalur objek instans ke GetInstanceByPath, yang mengembalikan instans.

Dalam versi kerangka kerja penyedia saat ini, pszInstancePath harus diselesaikan menjadi jalur instans pada komputer yang sama.

Meskipun pMethodContext memiliki nilai default NULL, konteks harus disediakan untuk mencegah kebuntuan. Gunakan konteks yang diteruskan ke penyedia oleh Penyedia::EnumerateInstances atau Provider::ExecQuery, atau dapatkan dari instans menggunakan CInstance::GetMethodContext.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemglue.h (termasuk FwCommon.h)
Pustaka	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Share via