Baca dalam bahasa Inggris

Bagikan melalui


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.

Antarmuka