IViewObject::GetAdvise

Retrieves the existing advisory connection on the object if there is one. This method simply returns the parameters used in the most recent call to the IViewObject::SetAdvise method.

HRESULT GetAdvise(

DWORD * pdwAspect,

//Pointer to where dwAspect parameter from previous SetAdvise call is returned

DWORD * padvf,

//Pointer to where advf parameter from previous SetAdvise call is returned

IAdviseSink ** ppAdvSink

//Indirect pointer to interface on an advise sink

);

Parameters

pdwAspect: [out] Pointer to where the dwAspect parameter from the previous 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 SetAdvise call is returned. If this pointer is NULL, the caller does not permit this value to be returned.
ppAdvSink: [out] Indirect pointer to an IAdviseSink interface on an advise sink. The connection to this advise sink must have been established with a previous SetAdvise call, which provides the pAdvSink parameter. If this pointer is NULL, there is no established advisory connection.

Return Values

This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following:

S_OK: The existing advisory connection was retrieved.

DWORD * pdwAspect,	//Pointer to where dwAspect parameter from previous SetAdvise call is returned
DWORD * padvf,	//Pointer to where advf parameter from previous SetAdvise call is returned
IAdviseSink ** ppAdvSink	//Indirect pointer to interface on an advise sink
);