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.
{
[id(1), helpstring("OnBegin")] HRESULT OnBegin();
[id(2), helpstring("OnUpdate")] HRESULT OnUpdate
([in] ULONG CurrentValuePercent);
[id(3), helpstring("OnEnd")] HRESULT OnEnd
([in] HRESULT hrResult);
};
Tabel berikut menjelaskan fungsi yang disediakan antarmuka ini.
Fungsi | Deskripsi |
---|---|
Menginstruksikan pustaka untuk memulai operasi. |
|
Menginstruksikan pustaka untuk melanjutkan kemajuan operasi. |
|
Mengembalikan kode status setelah akhir operasi. |