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

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 codeDescription
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

Minimum supported server

Windows 2000 Server

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IConnectionPoint is defined as B196B286-BAB4-101A-B69C-00AA00341D07

See also

IConnectionPoint

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ