IMAPITable::Unadvise
適用於:Outlook 2013 |Outlook 2016
取消傳送先前透過呼叫 IMAPITable::Advise 方法所設定的通知。
HRESULT Unadvise(
ULONG_PTR ulConnection
);
參數
ulConnection
[in]呼叫 IMAPITable::Advise 所傳回的註冊連線數目。
傳回值
S_OK
呼叫成功。
註解
使用 IMAPITable::Unadvise 方法,將指標釋出在先前呼叫 IMAPITable::Advise 時傳入 lpAdviseSink 參數的建議接收器物件,藉此取消通知註冊。 在捨棄建議接收物件的指標時,會呼叫物件的 IUnknown::Release 方法。 一般而言,在 Unadvise 呼叫期間會呼叫 Release,但如果另一個線程正在呼叫建議接收的 IMAPIAdviseSink::OnNotify 方法,則 Release 呼叫會延遲到 OnNotify 方法傳回為止。
如需通知程式的詳細資訊,請參閱 MAPI 中的事件通知。 如需數據表通知的特定資訊,請 參閱關於數據表通知。 如需使用 IMAPISupport 方法來支援通知的相關信息,請參閱 支援事件通知。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
ContentsTableListCtrl.cpp |
CContentsTableListCtrl::NotificationOff |
MFCMAPI 使用 IMAPITable::Unadvise 方法來取消數據表的通知。 |