IMAPIForm::Unadvise
The IMAPIForm::Unadvise
method removes a form viewer s registration for notification of form object
changes previously established with a call to the IMAPIForm::Advise method.
Quick Info
See IMAPIForm
: IUnknown.
HRESULT Unadvise(
|
ULONG ulConnection |
|
|
) |
|
Parameters
ulConnection
[in] Number
of the registration connection returned by a call to the IMAPIForm::Advise method.
Return Values
S_OK
The call
succeeded and has returned the expected value or values.
Remarks
Form viewers
call the IMAPIForm::Unadvise method to release the pointer to the view
advise sink object passed in the pAdvise parameter in the previous call
to IMAPIForm::Advise, thereby canceling a notification registration. As
part of discarding the pointer to the view advise sink, the view advise sink s IUnknown::Release
method is called. Generally, Release is called during the Unadvise
call, but if another thread is in the process of calling one of the IMAPIViewAdviseSink
methods for the view advise sink object, the Release call is delayed
until the method call returns.
See Also