Provider::P utInstance(constCInstance&,long) metode (provider.h)

  • Artikel

[Kelas Penyedia adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam status 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 PutInstance memperbarui instans.

Sintaks

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parameter

[ref] newInstance

Instans yang diperbarui.

lFlags

Bitmask bendera dengan informasi tentang operasi pembaruan. Ini adalah nilai yang ditentukan oleh klien dalam metode IWbemServices::P utInstance .

Bendera berikut ditangani oleh (dan difilter) oleh WMI:

  • WBEM_FLAG_RETURN_IMMEDIATELY
Nilai lFlags yang valid adalah:
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

Nilai kembali

Implementasi penyedia kerangka kerja default dari metode ini mengembalikan WBEM_E_PROVIDER_NOT_CAPABLE ke metode panggilan. Metode IWbemServices::P utInstance mencantumkan nilai pengembalian yang paling umum, meskipun Anda dapat memilih untuk mengembalikan kode pengembalian COM apa pun.

Keterangan

WMI memanggil PutInstance ketika klien memanggil IWbemServices::P utInstance terhadap kelas Anda. Anda harus menerapkan PutInstance jika penyedia kerangka kerja Anda memperbarui instans. Daftar berikut menjelaskan implementasi umum PutInstance:

  1. Periksa properti kunci yang diteruskan oleh klien dengan metode Get untuk CInstance, seperti CInstance::GetCHString.

    Implementasi Anda harus menentukan apakah penyedia Anda mendukung perubahan yang diminta oleh klien.

  2. Buat atau perbarui objek terkelola yang sesuai, seperlunya.
  3. Mengembalikan nilai pengembalian yang sesuai.

    Jika penyedia Anda tidak mendukung perubahan yang diminta oleh klien, Anda harus mengembalikan kode kesalahan yang sesuai. Untuk daftar lengkap kode kesalahan yang valid, lihat IWbemServices::P utInstance.

Persyaratan

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