IDataObject::DUnadvise method (objidl.h)

Destroys a notification connection that had been previously set up.

Syntax

HRESULT DUnadvise(
  [in] DWORD dwConnection
);

Parameters

[in] dwConnection

A token that specifies the connection to be removed. Use the value returned by IDataObject::DAdvise when the connection was originally established.

Return value

This method returns S_OK on success. Other possible values include the following.

Return code Description
OLE_E_NOCONNECTION
The specified value for dwConnection is not a valid connection.
OLE_E_ADVISENOTSUPPORTED
This IDataObject implementation does not support notification.

Remarks

This methods destroys a notification created with a call to the IDataObject::DAdvise method.

If the advisory connection being deleted was initially set up by delegating the IDataObject::DAdvise call to IDataAdviseHolder::Advise, you must delegate this call to IDataAdviseHolder::Unadvise to delete it.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header objidl.h

See also

IDataObject