IConnectionPoint::Unadvise method

Terminates an advisory connection previously established between a connection point object and a client's sink.

Syntax

HRESULT Unadvise(
  DWORD dwCookie
);

Parameters

dwCookie

A connection token previously returned from IConnectionPoint::Advise.

Return Value

This method can return the standard return values E_UNEXPECTED, as well as the following values.

Return code Description
S_OK
The connection was terminated successfully.
E_POINTER
The value in dwCookie does not represent a valid connection.

Remarks

When an advisory connection is terminated, the connection point calls the Release method on the pointer that was saved for the connection during the IConnectionPoint::Advise method. This Release reverses the AddRef that was performed during the Advise when the connection point calls the advisory sink's QueryInterface.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header ocidl.h

See Also

IConnectionPoint