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