IOleUIObjInfo::GetConvertInfo
Gets the
conversion information associated with the specified object.
HRESULT GetConvertInfo(
|
DWORD dwObject, |
//Unique 32-bit object identifier |
|
CLSID FAR
* lpClassID, |
//Pointer to location of CLSID of the object |
|
WORD FAR *lpwFormat, |
//Pointer to clipboard format of the object |
|
CLSID FAR
* lpConvertDefaultClassID, |
//Pointer to default class to convert object to |
|
LPCLSID
FAR * lplpClsidExclude, |
//Indirect pointer to excluded CLSIDs |
|
UINT FAR *
lpcClsidExclude |
//Pointer to number of CLSIDs in lplpClsidExclude |
|
); |
|
Parameters
dwObject
[in] Unique
32-bit identifier for the object.
lpClassID
[out] Pointer
to the location to return the object s CLSID.
lpwFormat
[out] Pointer
to the clipboard format of the object.
lpConvertDefaultClassID
[out] Pointer
to the default class, selected from the UI, to convert the object to.
lplpClsidExclude
[out]
Indirect pointer to an array of CLSIDs that should be excluded from the UI for
this object. May be NULL, if lpcClsidExclude is zero.
lpcClsidExclude
[out] Pointer
to number of CLSIDs in lplpClsidExclude. May be zero.
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 CLSID of the object at a minimum. lpwFormat may be left at zero
if the format of the storage is unknown.