OleUIConvert

Invokes the standard Convert dialog box, allowing the user to change the type of a single specified object, or the type of all OLE objects of the specified object’s class.

UINT OleUIConvert(

LPOLEUICONVERT lpCV

//Pointer to initialization structure

);

Parameter

lpCV: [in] Pointer to an OLEUICONVERT structure that contains information used to initialize the dialog box.

Return Values

Standard Success/Error Definitions

OLEUI_FALSE: Unknown failure (unused).
OLEUI_SUCCESS: No error, same as OLEUI_OK.
OLEUI_OK: The user pressed the OK button.
OLEUI_CANCEL: The user pressed the Cancel button.

Standard Field Validation Errors

OLEUI_ERR_STANDARDMIN: Errors common to all dialog boxes lie in the range OLEUI_ERR_STANDARDMIN to OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages in order to display error messages to the user.
OLEUI_ERR_STRUCTURENULL: The pointer to an OLEUIXXX structure passed into the function was NULL.
OLEUI_ERR_STRUCTUREINVALID: Insufficient permissions for read or write access to an OLEUIXXX structure.
OLEUI_ERR_CBSTRUCTINCORRECT: The cbstruct value is incorrect.
OLEUI_ERR_HWNDOWNERINVALID: The hWndOwner value is invalid.
OLEUI_ERR_LPSZCAPTIONINVALID: The lpszCaption value is invalid.
OLEUI_ERR_LPFNHOOKINVALID: The lpfnHook value is invalid.
OLEUI_ERR_HINSTANCEINVALID: The hInstance value is invalid.
OLEUI_ERR_LPSZTEMPLATEINVALID: The lpszTemplate value is invalid.
OLEUI_ERR_HRESOURCEINVALID: The hResource value is invalid.

Initialization Errors

OLEUI_ERR_FINDTEMPLATEFAILURE: Unable to find the dialog box template.
OLEUI_ERR_LOADTEMPLATEFAILURE: Unable to load the dialog box template.
OLEUI_ERR_DIALOGFAILURE: Dialog box initialization failed.
OLEUI_ERR_LOCALMEMALLOC: A call to LocalAlloc or the standard IMalloc allocator failed.
OLEUI_ERR_GLOBALMEMALLOC: A call to GlobalAlloc or the standard IMalloc allocator failed.
OLEUI_ERR_LOADSTRING: Unable to LoadString localized resources from the library.
OLEUI_ERR_OLEMEMALLOC: A call to the standard IMalloc allocator failed.

Function Specific Errors

OLEUI_ERR_STANDARDMAX: Errors common to all dialog boxes lie in the range OLEUI_ERR_STANDARDMIN to OLEUI_ERR_STANDARDMAX. This value allows the application to test for standard messages in order to display error messages to the user.
OLEUI_CTERR_CLASSIDINVALID: A clsid value was invalid.
OLEUI_CTERR_DVASPECTINVALID: The dvAspect value was invalid. This member specifies the aspect of the object.
OLEUI_CTERR_CBFORMATINVALID: The wFormat value was invalid. This member specifies the data format of the object.
OLEUI_CTERR_STRINGINVALID: A string value (for example, lpszUserType or lpszDefLabel) was invalid.

Remarks

OleUIConvert populates the Convert dialog box’s list box with object classes by traversing the Registry and looking for entries in the Readable and ReadWritable keys. Every class that includes the original class' default file format in its Readable key is added to the Convert list, and every class that includes the original class' default file format in its ReadWritable key is added to the Activate As list. The Convert list is shown in the dialog box's list box when the Convert radio button is selected (the default selection), and the Activate As list is shown when Activate As is selected.

Note that you can change the type of all objects of a given class only when CF_CONVERTONLY is not specified.

The convert command, which invokes this function, should only be made available to the user if OleUIConvertOrActivateAs returns S_OK.

LPOLEUICONVERT lpCV	//Pointer to initialization structure
);