Peristiwa ISWbemSinkEvents::OnProgress

Artikel
06/13/2023

Peristiwa OnProgressSWbemSink dipicu ketika panggilan asinkron mengembalikan status panggilan yang sedang berlangsung. Jika peristiwa, instans, atau kelas dihasilkan dari penyedia yang mendukung pembaruan status, Anda dapat menempatkan kode dalam peristiwa ini untuk memberi pengguna umpan balik tentang status operasi asinkron. Anda harus mengatur parameter iFlags dari panggilan asinkron ke wbemFlagSendStatus (128/0x80) jika Anda ingin menerima pembaruan status, jika tidak, peristiwa ini tidak dipicu.

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

Sintaks

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

Parameter

iUpperBound: Bilangan bulat yang menjelaskan jumlah total tugas yang harus diselesaikan.
iCurrent: Item saat ini yang sedang diproses.
strMessage: Pesan yang menjelaskan status tugas saat ini.
objWbemAsyncContext: Objek SWbemNamedValueSet yang diteruskan ke panggilan asinkron asli. Gunakan parameter ini untuk mengidentifikasi asal panggilan asinkron yang memicu peristiwa ini ketika beberapa panggilan asinkron dilakukan menggunakan sink objek ini.

Menampilkan nilai

Kejadian ini tidak mengembalikan nilai.

Kode kesalahan

Setelah selesainya peristiwa OnProgress , objek Err mungkin berisi salah satu kode kesalahan di bawah ini.

wbemErrFailed - 2147749889 (0x80041001): Kesalahan yang tidak ditentukan.
wbemErrOutOfMemory - 2147749894 (0x80041006): Tidak cukup memori untuk menyelesaikan operasi.
wbemErrTransportFailure - 2147749909 (0x80041015): Terjadi kesalahan jaringan, mencegah operasi normal.

Keterangan

Peristiwa OnProgress dipicu ketika panggilan asinkron mengembalikan status panggilan yang sedang berlangsung. Jika peristiwa, instans, atau kelas dihasilkan dari penyedia yang mendukung pembaruan status, Anda dapat menempatkan kode dalam peristiwa ini untuk memberikan umpan balik kepada pengguna tentang status operasi asinkron.

Catatan

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, gunakan komunikasi semi-sinkron atau sinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Lihat juga

SWbemSink

Bagikan melalui