Metode IWbemServices::D eleteClassAsync (wbemcli.h)

  • Artikel

Metode IWbemServices::D eleteClassAsync menghapus kelas yang ditentukan dari namespace saat ini. Metode ini identik dengan IWbemServices::D eleteClass kecuali bahwa panggilan segera kembali. Konfirmasi atau kegagalan secara asinkron dilaporkan ke sink objek yang ditentukan menggunakan metode IWbemObjectSink::SetStatus setelah operasi selesai.

Sintaks

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Parameter

[in] strClass

Nama kelas yang ditargetkan untuk dihapus.

[in] lFlags

Satu atau beberapa nilai berikut ini valid.

WBEM_FLAG_SEND_STATUS

Bendera ini mendaftar dengan Manajemen Windows permintaan untuk menerima laporan status perantara melalui implementasi klien IWbemObjectSink::SetStatus. Implementasi penyedia harus mendukung pelaporan status perantara, agar bendera ini berubah perilaku.

WBEM_FLAG_OWNER_UPDATE

Penyedia pendorongan harus menentukan bendera ini saat memanggil DeleteClassAsync untuk menunjukkan bahwa kelas ini telah berubah.

[in] pCtx

Biasanya NULL. Jika tidak, ini adalah penunjuk ke objek IWbemContext yang dapat digunakan oleh penyedia yang menghapus kelas . Nilai dalam objek konteks harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI.

[in] pResponseHandler

Arahkan ke implementasi IWbemObjectSink yang diimplementasikan oleh pemanggil. Handler ini menerima status permintaan penghapusan ketika tersedia melalui metode IWbemObjectSink::SetStatus . Jika ada kode kesalahan yang dikembalikan, maka pointer IWbemObjectSink yang disediakan tidak digunakan. Jika WBEM_S_NO_ERROR dikembalikan, maka implementasi IWbemObjectSink pengguna dipanggil untuk menunjukkan hasil operasi. Manajemen Windows hanya memanggil AddRef pada penunjuk jika WBEM_S_NO_ERROR kembali. Dalam kasus di mana kode kesalahan kembali, jumlah referensi sama dengan pada entri. Untuk penjelasan terperinci tentang parameter ini, lihat Memanggil Metode.

Mengembalikan nilai

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

Semua kode pengembalian lainnya disediakan ke sink objek yang ditentukan oleh parameter pReponseHandler melalui metode SetStatus . Kondisi kesalahan, seperti ketika kelas tidak ada atau pengguna tidak memiliki izin untuk menghapus kelas, dilaporkan ke handler. Mereka tidak dilaporkan dalam kode pengembalian metode ini.

Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

Keterangan

Jika penyedia instans dinamis dikaitkan dengan kelas , penyedia tidak terdaftar, dan tidak lagi dipanggil untuk kelas tersebut. Setiap kelas yang berasal dari kelas yang dihapus juga dihapus, dan penyedia terkait menjadi tidak terdaftar. Semua instans statis yang luar biasa dari kelas yang ditentukan dan subkelasnya juga dihapus saat kelas dihapus.

Jika kelas disediakan oleh penyedia kelas dinamis, keberhasilan penghapusan tergantung pada apakah penghapusan kelas didukung oleh penyedia tersebut.

Catatan Kelas sistem standar tidak dapat dihapus.
 
Karena panggilan balik mungkin tidak dikembalikan pada tingkat autentikasi yang sama dengan yang dibutuhkan klien, disarankan agar Anda menggunakan semisinkron alih-alih komunikasi asinkron. Jika Anda memerlukan komunikasi asinkron, lihat Memanggil Metode.

Untuk informasi selengkapnya tentang menggunakan metode secara semisinkron, lihat IWbemServices::D eleteClass dan Memanggil Metode.

Persyaratan

   
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
DLL Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Lihat juga

IWbemServices

IWbemServices::D eleteClass

Mengambil Kode Kesalahan