IOleUIObjInfo::GetConvertInfo method
Gets the conversion information associated with the specified object.
Syntax
HRESULT GetConvertInfo(
[in] DWORD dwObject,
[out] CLSID *lpClassID,
[out] WORD *lpwFormat,
[out] CLSID *lpConvertDefaultClassID,
[out] LPCLSID *lplpClsidExclude,
[out] UINT *lpcClsidExclude
);
Parameters
- dwObject [in]
-
Unique 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]
-
Address of a pointer variable that receives a pointer to an array of CLSIDs that should be excluded from the user interface for this object. If lpcClsidExclude is zero, then lpClsidExclude is set to NULL.
- lpcClsidExclude [out]
-
Address of an output variable that receives the number of CLSIDs in lplpClsidExclude. This parameter may be zero.
Return value
This method returns S_OK on success. Other possible return values include the following.
| Return code | Description |
|---|---|
|
Insufficient access permissions. |
|
The operation failed. |
|
The specified identifier is invalid. |
|
There is insufficient memory available for this operation. |
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.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
See also