IViewObject::GetAdvise method (oleidl.h)

Retrieves the advisory connection on the object that was used in the most recent call to IViewObject::SetAdvise.

Syntax

HRESULT GetAdvise(
  [out] DWORD       *pAspects,
  [out] DWORD       *pAdvf,
  [out] IAdviseSink **ppAdvSink
);

Parameters

[out] pAspects

Pointer to where the dwAspect parameter from the previous IViewObject::SetAdvise call is returned. If this pointer is NULL, the caller does not permit this value to be returned.

[out] pAdvf

Pointer to where the advf parameter from the previous IViewObject::SetAdvise call is returned. If this pointer is NULL, the caller does not permit this value to be returned.

[out] ppAdvSink

Address of IAdviseSink pointer variable that receives the interface pointer to the advise sink. The connection to this advise sink must have been established with a previous IViewObject::SetAdvise call, which provides the pAdvSink parameter. If ppvAdvSink is NULL, there is no established advisory connection.

Return value

This method returns S_OK on success.

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	oleidl.h

See also

ADVF

IAdviseSink

IViewObject

IViewObject::SetAdvise