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.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oledlg.h.

See Also

OLEUIVIEWPROPS