MAPI進度指標
適用於:Outlook 2013 |Outlook 2016
您為客戶端執行的許多作業可能需要很長的時間才能完成。 若要通知用戶端長時間作業的進度,您可以顯示指標,以圖形方式顯示作業完成的部分,從作業開始到完成的任何指定點。 進度指示器會顯示要完成的總作業百分比。
下列方法支援冗長的作業和進度指示器的顯示:
IMAPIFolder::CopyMessages、 IMAPIFolder::CopyFolder、 IMAPIFolder::D eleteMessages、 IMAPIFolder::D eleteFolder、 IMAPIFolder::EmptyFolder 和 IMAPIFolder::SetReadFlags。
IMAPISupport::D oCopyProps、 IMAPISupport::D oCopyTo、 IMAPISupport::CopyFolder 和 IMAPISupport::CopyMessages。
若要顯示進度指標,MAPI 會定義進度物件。 Progress 物件會實作 IMAPIProgress:IUnknown 介面,這個介面包含建立指標範圍和建立顯示器的方法。 MAPI 提供進度對象實作,就像某些客戶端一樣。 如果提供實作,您應該使用用戶端的 實作做為執行作業之方法的輸入參數。 如果客戶端傳遞 NULL 而不是進度物件的指標,請呼叫 IMAPISupport::D oProgressDialog 方法來使用 MAPI 的實作。