IMAPITable::WaitForCompletion
適用於:Outlook 2013 |Outlook 2016
暫停處理,直到數據表上一或多個進行中的異步操作完成為止。
HRESULT WaitForCompletion(
ULONG ulFlags,
ULONG ulTimeout,
ULONG FAR * lpulTableStatus
);
參數
ulFlags
保留;必須是零。
ulTimeout
[in]等待異步操作或作業完成的最大毫秒數。 若要無限期地等待完成,請將 ulTimeout 設定為 0xFFFFFFFF。
lpulTableStatus
[in, out]在輸入時,為有效的指標或 NULL。 在輸出中,如果 lpulTableStatus 是有效的指標,它會指向數據表的最新狀態。 如果 lpulTableStatus 為 NULL,則不會傳回任何狀態資訊。 如果 WaitForCompletion 傳回失敗的 HRESULT 值, 則 lpulTableStatus 的內容不會定義。
傳回值
S_OK
等候作業成功。
MAPI_E_NO_SUPPORT
數據表不支援等待異步操作完成。
MAPI_E_TIMEOUT
異步操作或作業未在指定的時間內完成。
註解
IMAPITable::WaitForCompletion 方法會暫停處理,直到目前針對數據表進行的任何異步操作都已完成為止。 WaitForCompletion 可讓異步操作完全完成或執行特定毫秒數,如 ulTimeout 所示,再中斷。 若要偵測進行中的異步操作,請呼叫 IMAPITable::GetStatus 方法。