IMAPISupport::Unsubscribe
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Cancels the responsibility for sending notifications that was previously established with a call to the IMAPISupport::Subscribe method.
HRESULT Unsubscribe(
ULONG ulConnection
);
Parameters
- ulConnection
[in] The nonzero connection number that represents the notification registration previously established through IMAPISupport::Subscribe.
Return Value
S_OK
The notification registration was canceled.MAPI_E_NOT_FOUND
The connection number passed in the ulConnection parameter does not exist.
Remarks
The IMAPISupport::Unsubscribe method is implemented for all service provider support objects. Service providers call Unsubscribe to cancel a notification registration previously set up by Subscribe. Unsubscribe cancels the registration by releasing the advise sink pointer passed in the Subscribe call.
Generally, the advise sink's IUnknown::Release method is called during the Unsubscribe call. However, if another thread is in the process of calling the IMAPIAdviseSink::OnNotify method for the advise sink object, the Release call is delayed until the OnNotify method returns.