IOleUIObjInfoW::GetConvertInfo method (oledlg.h)

Gets the conversion information associated with the specified object.

Syntax

HRESULT GetConvertInfo(
  DWORD   dwObject,
  CLSID   *lpClassID,
  WORD    *lpwFormat,
  CLSID   *lpConvertDefaultClassID,
  LPCLSID *lplpClsidExclude,
  UINT    *lpcClsidExclude
);

Parameters

dwObject

Unique identifier for the object.

lpClassID

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

lpwFormat

Pointer to the clipboard format of the object.

lpConvertDefaultClassID

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

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.

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
E_ACCESSDENIED
Insufficient access permissions.
E_FAIL
The operation failed.
E_INVALIDARG
The specified identifier is invalid.
E_OUTOFMEMORY
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]
Target Platform Windows
Header oledlg.h

See also

IOleUIObjInfo