IMAPIProgress:IUnknown
適用於:Outlook 2013 |Outlook 2016
實作進度物件,為用戶端應用程式提供進度指示器。 進度指標是顯示作業完成百分比的使用者介面顯示,例如在訊息存放區之間複製資料夾。 MAPI 和用戶端應用程式會實作進度物件,而服務提供者會使用它們。
屬性 | 值 |
---|---|
標頭檔: |
Mapidefs.h |
公開者: |
Progress 物件 |
實作者: |
MAPI 和用戶端應用程式 |
通話者: |
服務提供者 |
介面識別碼: |
IID_IMAPIProgress |
指標類型: |
LPMAPIPROGRESS |
Vtable 順序
成員 | 描述 |
---|---|
Progress |
匯報 進度指標,並顯示作業完成時的進度。 |
GetFlags |
針對計算進度資訊的作業層級,從進度對象傳回旗標設定。 |
GetMax |
傳回作業中顯示進度資訊的項目數目上限。 |
GetMin |
傳回 SetLimits 方法中顯示進度資訊的最小值。 |
SetLimits |
設定作業中項目數的下限和上限,以及控制作業之進度信息計算方式的旗標。 |
註解
MAPI 在許多可能執行冗長作業的方法中包含 lpProgress 參數。 lpProgress 指向進度物件的用戶端實作。 實作 IMAPIProgress 介面的用戶端會將此參數設定為指向其實作;未實作 IMAPIProgress 的用戶端會將 參數設定為 NULL。 若要在作業處理期間顯示進度指示器,服務提供者會使用用戶端所提供的進度物件,如果有的話,或是當 lpProgress 設定為 NULL) 時所指示的 MAPI 實作 (。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
Files | Function | Comment |
---|---|---|
MapiProgress.h 和 MapiProgress.cpp |
不適用 |
如果啟用 IMAPIProgress 設定,MFCMAPI 會將 IMAPIProgress 實作傳遞給 MFCMAPI 所叫用且接受實作的所有函式。 |