AdviseDisconnect

HRESULT WINAPI AdviseDisconnect(
LPUNKNOWN pUnkNotifier, 
REFIID riid, 
LPUNKNOWN pUnkNotify, 
DWORD dwCookie, 
BOOL fAddRef )

Parameters

pUnkNotifier

Object from which notifications are originating. This object must implement IConnectionPointContainer.

riid

UUID of the notification interface to be used for the connection.

pUnkNotify

Pointer to IUnknown of the object to receive notifications. This object must implement the notification interface identified by the riid parameter. This parameter is ignored if fAddRef is FALSE.

pdwCookie

DWORD cookie from a previous call to AdviseConnect.

fAddRef

 TRUE if a reference count was kept on pUnkNotify during the connection. If TRUE, then pUnkNotify must be a valid pointer to the original IUnknown used in a prior call to AdviseConnection. Otherwise, it is ignored.

Return Code

S_OK

Method succeeded.

E_NOINTERFACE

E_OUTOFMEMORY

Comments

Called to disconnect an advisory connection. dwCookie must be the value returned from the prior call to AdviseConnect, and pUnkNotifier, riid, pUnkNotify, and fAddRef must be the same as the prior call to AdviseConnect. If fAddRef is FALSE, then pUnkNotify is not used.