Metode IWbemConfigureRefresher::AddObjectByTemplate (wbemcli.h)

Dengan metode IWbemConfigureRefresher::AddObjectByTemplate , Anda dapat menambahkan objek yang ingin Anda refresh ke penyegaran dengan menentukan templat instans IWbemClassObject . Gunakan metode ini ketika sulit untuk membangun jalur objek untuk objek untuk ditambahkan ke penyegaran.

Catatan Properti utama objek instans harus diisi sebelum Anda dapat memanggil metode AddObjectByTemplate .

 

Sintaks

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parameter

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] pTemplate

Penunjuk ke objek IWbemClassObject yang berisi templat instans.

[in] lFlags

Bitmask bendera yang memodifikasi perilaku metode ini. Jika parameter ini diatur ke WBEM_FLAG_USE_AMENDED_QUALIFIERS, instans yang dikembalikan akan 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 akan 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 ini.

Nilai kembali

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

Keterangan

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

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