Metode CWbemProviderGlue::GetInstancePropertiesByPath (wbemglue.h)

Artikel
03/09/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 GetInstancePropertiesByPath mengambil instans yang diidentifikasi oleh jalur objek tertentu, hanya dengan properti yang ditentukan yang diisi. Properti yang akan diisi dinamai dalam array CHString .

Sintaks

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Parameter

pszInstancePath

Jalur objek ke instans yang akan dikembalikan. Parameter ini harus menunjuk ke jalur lengkap.

ppInstance

Pointer ke pointer ke instans CInstance baru yang kuncinya ditentukan oleh 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.

[ref] csaProperties

Array yang berisi nama properti yang akan disalin ke dalam instans baru.

Mengembalikan nilai

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 yang ditentukan dari objek yang ditentukan. Ini adalah cara paling efisien untuk mengambil instans tertentu ketika lebih banyak properti daripada hanya kunci yang diperlukan. Ketahuilah bahwa tidak semua penyedia mendukung operasi instans parsial. Dalam hal ini, seluruh instans (termasuk kunci) 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

GetInstanceKeysByPath

Bagikan melalui