IMAPISupport::Unsubscribe

The IMAPISupport::Unsubscribe method cancels the responsibility for sending notifications that was previously established with a call to the IMAPISupport::Subscribe method.

Quick Info

See IMAPISupport : IUnknown.

HRESULT Unsubscribe(
  ULONG ulConnection  
);

Parameters

ulConnection: [in] The non-zero connection number representing the notification registration previously established through IMAPISupport::Subscribe.

Return Values

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, but 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.