IConnectionPoint::Unadvise method (ocidl.h)

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

Syntax

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parameters

[in] 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

Requirement Value
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