Edit

IConnectionPoint::Unadvise method (ocidl.h)

  • Article

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

   
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