Metode IWbemConfigureRefresher::AddObjectByPath (wbemcli.h)

Artikel
03/08/2023

Metode IWbemConfigureRefresher::AddObjectByPath menambahkan objek ke penyegaran dengan menentukan jalur objek.

Sintaks

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parameter

[in] pNamespace

Pointer IWbemServices kembali ke Manajemen Windows, yang dapat melayani permintaan apa pun yang dibuat oleh penyedia. Penyedia harus memanggil AddRef pada pointer ini jika akan memanggil kembali ke Manajemen Windows selama eksekusinya.

[in] wszPath

String konstanta yang dihentikan null dari karakter Unicode 16-bit yang berisi jalur objek objek yang Anda tambahkan ke penyegaran.

[in] lFlags

Bitmask bendera yang memodifikasi perilaku metode ini. Jika parameter ini diatur ke WBEM_FLAG_USE_AMENDED_QUALIFIERS, instans yang dikembalikan berisi kualifikasi yang dilokalkan jika tersedia.

[in] pContext

Biasanya NULL; jika tidak, penunjuk ke objek IWbemContext yang diperlukan oleh satu atau beberapa penyedia kelas dinamis. Nilai dalam objek konteks harus ditentukan dalam dokumentasi penyedia tertentu. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI.

[out] ppRefreshable

Penunjuk untuk menyimpan referensi ke objek IWbemClassObject , yang berisi objek instans yang dapat di-refresh. Klien harus memanggil Rilis pada objek yang dikembalikan ketika tidak lagi diperlukan.

[out] plId

Penunjuk ke bilangan bulat yang dikembalikan oleh penyedia yang secara unik mengidentifikasi objek yang dapat disegarkan.

Nilai kembali

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

Keterangan

Jalur yang disediakan harus menentukan objek yang valid, yang disediakan oleh Penyedia High-Performance. Objek yang dikembalikan tidak boleh disentuh oleh klien saat operasi refresh sedang dalam proses. Pengidentifikasi yang dikembalikan dapat digunakan oleh fungsi Hapus untuk menghapus objek.

Catatan Pengguna tidak perlu menghapus objek yang ditambahkan secara eksplisit. Klien harus memanggil Rilis pada objek yang dikembalikan ketika tidak lagi diperlukan.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

Mengakses Data Performa di C++

IWbemConfigureRefresher

Membuat Penyedia Instans menjadi Penyedia High-Performance

Penyedia Penghitung Kinerja

Bagikan melalui