This topic has not yet been rated - Rate this topic

IConnectionPoint::Unadvise method

Applies to: desktop apps | Metro style apps

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

Syntax

Copy

HRESULT Unadvise(
  [in]  DWORD dwCookie
);

Parameters

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