IOleObject::Unadvise method

Deletes a previously established advisory connection.

Syntax


HRESULT Unadvise(
  [in] DWORD dwConnection
);

Parameters

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

Return value

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

Return code	Description
E_FAIL	The operation failed.
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 IOleObject::Unadvise.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	OleIdl.h
IDL	OleIdl.Idl
IID	IID_IOleObject is defined as 00000112-0000-0000-C000-000000000046