IControlProgressHandler

Antarmuka ini adalah handler sisi klien yang menerima pembaruan saat pustaka melakukan operasi. Pustaka kemudian menjalankan panggilan balik sinkron ke klien yang menunjukkan kemajuan operasi. Bergantung pada tindakan pengguna, kode pengembalian klien menginstruksikan pustaka baik untuk melanjutkan operasi atau membatalkannya. Proses ini memungkinkan UI untuk menunjukkan kemajuan operasi panjang kepada pengguna seperti Simpan. Jika pengguna memilih untuk membatalkan operasi, UI mengembalikan kode yang sesuai ke pustaka.

Sintaks

{
  [id(1), helpstring("OnBegin")] HRESULT OnBegin();
  [id(2), helpstring("OnUpdate")] HRESULT OnUpdate
    ([in] ULONG CurrentValuePercent);
  [id(3), helpstring("OnEnd")] HRESULT OnEnd
    ([in] HRESULT hrResult);
};

Fungsi

Tabel berikut menjelaskan fungsi yang disediakan antarmuka ini.

Fungsi	Deskripsi
OnBegin	Menginstruksikan pustaka untuk memulai operasi.
OnUpdate	Menginstruksikan pustaka untuk melanjutkan kemajuan operasi.
OnEnd	Mengembalikan kode status setelah akhir operasi.

Topik terkait

Antarmuka