IOleObject::Unadvise

Deletes a previously established advisory connection.

HRESULT Unadvise(
  DWORD dwConnection  //Token
);

Parameter

dwConnection: [in] Contains a token of nonzero value, which was previously returned from IOleObject::Advise through its pdwConnection parameter.

Return Values

This method supports the standard return value E_FAIL, as well as the following:

S_OK: Advisory connection deleted successfully.
OLE_E_NOCONNECTION: dwConnection does not represent a valid advisory connection.

Remarks

Normally, containers call IOleObject::Unadvise at shutdown or when an object is deleted. In certain cases, containers can call this method on objects that are running but not currently visible as a way of reducing the overhead of maintaining multiple advisory connections. The easiest way to implement this method is to delegate the call to IOleAdviseHolder::Unadvise.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oleidl.h.