Bagikan melalui

Metode CWbemProviderGlue::GetInstanceKeysByPath (wbemglue.h)

  • Artikel

[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 GetInstanceKeysByPath mengambil instans yang diidentifikasi oleh jalur objek tertentu, hanya dengan properti kunci yang diisi.

Sintaks

HRESULT GetInstanceKeysByPath(
  LPCWSTR       pszInstancePath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

Parameter

pszInstancePath

Jalur objek ke instans yang akan dikembalikan.

ppInstance

Pointer ke pointer ke instans CInstance baru yang kuncinya adalah yang ditentukan dalam pszInstancePath. 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 ini menggunakan operasi pembaruan instans parsial untuk meminta hanya properti kunci dari objek yang ditentukan. Ini adalah cara paling efisien untuk memverifikasi keberadaan objek tertentu. Ketahuilah bahwa tidak semua penyedia mendukung operasi instans parsial. Dalam hal ini, seluruh instans akan diisi. Untuk informasi selengkapnya, lihat Mendukung Operasi Partial-Instance.

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

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

Lihat juga

CWbemProviderGlue

GetInstanceByPath

GetInstancePropertiesByPath