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.