Metode SWbemServices.DeleteAsync

Artikel
06/13/2023

Metode DeleteAsync objek SWbemServices menghapus kelas atau instans yang ditentukan di jalur objek. Panggilan ke DeleteAsync segera kembali dan hasil dan status dikembalikan ke pemanggil melalui peristiwa yang dikirimkan ke sink yang ditentukan dalam objWbemSink. Untuk informasi selengkapnya tentang membuat sink, lihat Menerima Peristiwa WMI. Anda hanya dapat menghapus objek di namespace layanan tempat Anda tersambung.

Jika penyedia dinamis menyediakan kelas atau instans, terkadang tidak dimungkinkan untuk menghapus objek ini kecuali penyedia mendukung penghapusan kelas atau instans.

Metode ini dipanggil dalam mode asinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.

Sintaks

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

ObjWbemSink [opsional]: Sink objek yang menerima hasil penghapusan. Buat objek SWbemSink untuk menerima objek.
strObjectPath: Wajib diisi. String yang berisi jalur objek ke objek yang ingin Anda hapus. Untuk informasi selengkapnya, lihat Menjelaskan Lokasi Objek WMI.
iFlags [opsional]: Menentukan apakah pembaruan status dikembalikan. Parameter ini dapat menerima nilai berikut.
wbemFlagSendStatus (128 (0x80)): Menyebabkan panggilan asinkron mengirim pembaruan status ke penanganan aktivitas OnProgress untuk sink objek.
wbemFlagDontSendStatus (0 (0x0)): Mencegah panggilan asinkron mengirim pembaruan status ke penanganan aktivitas OnProgress untuk sink objek.

objWbemNamedValueSet [opsional]

Biasanya, ini tidak ditentukan. Jika tidak, ini adalah objek SWbemNamedValueSet yang elemennya mewakili informasi konteks yang dapat digunakan oleh penyedia yang melayani permintaan. Penyedia yang mendukung atau memerlukan informasi tersebut harus mendokumentasikan nama nilai yang dikenali, jenis data nilai, nilai yang diizinkan, dan semantik.

objWbemAsyncContext [opsional]

Objek SWbemNamedValueSet yang kembali ke sink objek untuk mengidentifikasi sumber panggilan asinkron asli. Gunakan parameter ini jika Anda melakukan beberapa panggilan asinkron menggunakan sink objek yang sama. Untuk menggunakan parameter ini, buat objek SWbemNamedValueSet dan gunakan metode SWbemNamedValueSet.Add untuk menambahkan nilai yang mengidentifikasi panggilan asinkron yang Anda lakukan. Objek SWbemNamedValueSet ini dikembalikan ke sink objek dan sumber panggilan dapat diekstraksi menggunakan metode SWbemNamedValueSet.Item . Untuk informasi selengkapnya, lihat Memanggil Metode.

Nilai kembali

Metode ini tidak mengembalikan nilai. Jika panggilan berhasil, sink objek menerima pemberitahuan penghapusan.

Kode kesalahan

Setelah penyelesaian metode DeleteAsync , objek Err mungkin berisi salah satu kode kesalahan dalam daftar berikut.

wbemErrFailed - 2147749889 (0x80041001): Kesalahan yang tidak ditentukan.
wbemErrInvalidParameter - 2147749896 (0x80041008): Parameter tidak valid ditentukan.
wbemErrOutOfMemory - 2147749894 (0x80041006): Tidak cukup memori untuk menyelesaikan operasi.
wbemErrTransportFailure - 2147749909 (0x80041015): Terjadi kesalahan jaringan, mencegah operasi normal.
wbemErrAccessDenied - 2147749891 (0x80041003): Nama pengguna dan kata sandi saat ini atau yang ditentukan tidak valid atau berwenang untuk membuat koneksi.
wbemErrNotFound - 2147749890 (0x80041002): Item yang diminta tidak ditemukan.

Keterangan

Panggilan ini segera kembali. Status operasi penghapusan dikembalikan ke pemanggil melalui panggilan balik yang dikirimkan ke sink yang ditentukan dalam objWbemSink. Anda dapat melakukan pemrosesan akhir dalam implementasi objWbemSink Anda. Peristiwa OnCompleted .

Panggilan balik asinkron memungkinkan pengguna yang tidak diautentikasi untuk menyediakan data ke sink. Ini menimbulkan risiko keamanan terhadap skrip dan aplikasi Anda. Untuk menghilangkan risiko, lihat Mengatur Keamanan pada Panggilan Asinkron.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Wbemdisp.h
Pustaka jenis	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

Lihat juga

SWbemServices
SWbemObjectPath

Bagikan melalui