IOleUIObjInfoW::GetConvertInfo method (oledlg.h)

Gets the conversion information associated with the specified object.


HRESULT GetConvertInfo(
  [in]  DWORD   dwObject,
  [out] CLSID   *lpClassID,
  [out] WORD    *lpwFormat,
  [out] CLSID   *lpConvertDefaultClassID,
  [out] LPCLSID *lplpClsidExclude,
  [out] UINT    *lpcClsidExclude


[in] dwObject

Unique identifier for the object.

[out] lpClassID

Pointer to the location to return the object's CLSID.

[out] lpwFormat

Pointer to the clipboard format of the object.

[out] lpConvertDefaultClassID

Pointer to the default class, selected from the UI, to convert the object to.

[out] lplpClsidExclude

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.

[out] lpcClsidExclude

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.


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.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header oledlg.h

See also