Metode IWbemServices::D eleteInstanceAsync (wbemcli.h)

Artikel
08/27/2023

Metode IWbemServices::D eleteInstanceAsync secara asinkron menghapus instans kelas yang ada di namespace saat ini. Konfirmasi atau kegagalan operasi dilaporkan melalui antarmuka IWbemObjectSink yang diterapkan oleh pemanggil.

Sintaks

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

Parameter

[in] strObjectPath

BSTR valid yang berisi jalur objek objek yang akan dihapus.

[in] lFlags

WBEM_FLAG_SEND_STATUS 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. Perhatikan bahwa bendera WBEM_FLAG_USE_AMENDED_QUALIFIERS tidak dapat digunakan di sini.

[in] pCtx

Biasanya NULL. Jika tidak, ini adalah penunjuk ke objek IWbemContext yang dapat digunakan oleh penyedia yang menghapus instans. Nilai dalam objek konteks harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan.

[in] pResponseHandler

Arahkan ke implementasi pemanggil IWbemObjectSink. Handler ini menerima status operasi penghapusan saat tersedia melalui metode 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 informasi selengkapnya, lihat Memanggil Metode.

Mengembalikan nilai

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

Jika gagal, Anda dapat memperoleh informasi apa pun yang tersedia dari fungsi COM GetErrorInfo.

Jika DeleteInstanceAsync mengembalikan WBEM_S_NO_ERROR, WMI menunggu hasil dari metode SetStatus penangan respons. WMI menunggu tanpa batas waktu pada koneksi lokal, atau sampai waktu koneksi jarak jauh habis.

Kondisi kesalahan lainnya dilaporkan secara asinkron ke sink objek yang disediakan oleh parameter pResponseHandler .

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

Catatan Klien yang memanggil DeleteInstanceAsync harus selalu mengharapkan hasil panggilan dilaporkan menggunakan metode IWbemObjectSink::Indicate mereka.

Catatan Ketika instans yang ditunjukkan oleh strObjectPath milik kelas yang merupakan anggota hierarki kelas, keberhasilan DeleteInstanceAsync tergantung pada penyedia non-abstrak teratas. Untuk penjelasan terperinci tentang dependensi yang terlibat yang menentukan keberhasilan operasi ini, lihat Komentar di IWbemServices::D eleteInstance.

Keterangan

Penyedia instans dapat melaporkan keberhasilan atau kegagalan dengan kode pengembalian dari DeleteInstanceAsync atau melalui panggilan ke SetStatus yang dilakukan melalui pResponseHandler. Jika dikirim ke SetStatus, kode pengembalian yang dikirim ke sink melalui pResponseHandler lebih diutamakan. 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 eleteInstance 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

Memanggil Metode

Menjelaskan Jalur Objek Instans

IWbemServices

IWbemServices::D eleteInstance

Bagikan melalui