IViewObject::GetAdvise method

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

Syntax

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

Parameters

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.

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.

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

   
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