IMAPISupport::Unsubscribe
適用於:Outlook 2013 |Outlook 2016
取消傳送先前透過呼叫 IMAPISupport::Subscribe 方法所建立之通知的責任。
HRESULT Unsubscribe(
ULONG ulConnection
);
參數
ulConnection
[in]非零連接編號,表示先前透過 IMAPISupport::Subscribe 建立的通知註冊。
傳回值
S_OK
通知註冊已取消。
MAPI_E_NOT_FOUND
傳入 ulConnection 參數的連接編號不存在。
註解
針對所有服務提供者支持物件實作 IMAPISupport::Unsubscribe 方法。 服務提供者呼叫 Unsubscribe 以取消先前由 訂閱所設定的通知註冊。 取消訂閱 會藉由釋放在 訂閱 呼叫中傳遞的建議接收指標來取消註冊。
一般而言,會在取消訂閱呼叫期間呼叫建議接收的IUnknown::Release 方法。 不過,如果另一個線程正在呼叫建議接收物件的 IMAPIAdviseSink::OnNotify 方法, 則 Release 呼叫會延遲到 OnNotify 方法傳回為止。