IOleUIObjInfo::GetViewInfo

Gets the view information associated with the object.

HRESULT GetViewInfo(

DWORD dwObject,	//Unique 32-bit object identifier
HGLOBAL FAR * phMetaPict,	//Pointer to object’s current icon
DWORD * pdvAspect,	///Pointer to object’s current aspect
int * pnCurrentScale	///Pointer to object’s current scale
);

Parameters

dwObject

[in] Unique 32-bit identifier for the object.

phMetaPict

[in] Pointer to the object’s current icon. Could be NULL, indicating that the caller is not interested in the object’s current presentation.

pdvAspect

[in] Pointer to the object’s current aspect. Could be NULL, indicating that the caller is not interested in the object’s current aspect, i.e., DVASPECT_ICONIC or DVASPECT_CONTENT.

pnCurrentScale

[in] Pointer to the object’s current scale. Could be NULL, indicating that the caller is not interested in the current scaling factor applied to the object in the container’s view.

Return Values

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

S_OK

Successfully returned link information.

E_ACCESSDENIED

Insufficient access permissions.

Remarks

Notes To Implementers

You must fill in the object’s current icon, aspect, and scale.

See Also

OLEUIVIEWPROPS