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 メソッドが呼び出されます。 一般に、 Release は Unadvise 呼び出し中に呼び出されますが、別のスレッドがアドバイズ シンクの IMAPIAdviseSink::OnNotify メソッドを呼び出している場合、 Release 呼び出しは OnNotify メソッドが返されるまで遅延されます。
通知プロセスの詳細については、「 MAPI でのイベント通知」を参照してください。 テーブル通知の詳細については、「テーブル通知 について」を参照してください。 IMAPISupport メソッドを使用して通知をサポートする方法については、「イベント通知のサポート」を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::NotificationOff |
MFCMAPI では、 IMAPITable::Unadvise メソッドを使用して、テーブルの通知を取り消します。 |