AfxConnectionUnadvise

 

Call this function to disconnect a connection between a source, specified by pUnkSrc, and a sink, specified by pUnkSink.

Syntax

      BOOL AFXAPI AfxConnectionUnadvise(
   LPUNKNOWN pUnkSrc,
   REFIID iid,
   LPUNKNOWN pUnkSink,
   BOOL bRefCount,
   DWORD dwCookie 
);

Parameters

  • pUnkSrc
    A pointer to the object that calls the interface.

  • pUnkSink
    A pointer to the object that implements the interface.

  • iid
    The interface ID of the connection point interface.

  • bRefCount
    TRUE indicates that disconnecting the connection should cause the reference count of pUnkSink to be decremented. FALSE indicates that the reference count should not be decremented.

  • dwCookie
    The connection identifier returned by AfxConnectionAdvise.

Return Value

Nonzero if a connection was disconnected; otherwise 0.

Example

//mysink is a CCmdTarget-derived class supporting automation.
//Get a pointer to sink's IUnknown, no AddRef done.
IID iid = IID_IUnknown;
IUnknown* pUnkSink = mysink.GetInterface(&iid);

//Terminate a connection between source and sink.
//pUnkSrc is IUnknown of server obtained by CoCreateInstance().
//dwCookie is a value obtained through AfxConnectionAdvise().
AfxConnectionUnadvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, dwCookie);

Requirements

Header: afxctl.h

See Also

MFC Macros and Globals
AfxConnectionAdvise