IViewObject::GetAdvise method

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

pAspects [out]

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.

pAdvf [out]

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.

ppAdvSink [out]

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

See also

IViewObject

ADVF

IAdviseSink

IViewObject::SetAdvise