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 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 |
| 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: 1/7/2010
Build type: MSDN