OleUIConvertA 函数 (oledlg.h)
调用标准“ 转换 ”对话框，允许用户更改单个指定对象的类型，或指定对象的类的所有 OLE 对象的类型。
语法
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
参数
[in] unnamedParam1
指向包含用于初始化对话框的信息 的 OLEUICONVERT 结构的指针。
返回值
标准成功/错误定义
| 返回代码 | 说明 |
|---|---|
|
未知故障 (未使用的) 。 |
|
用户按下了“确定”按钮。 |
|
无错误，与 OLEUI_OK 相同。 |
|
用户按下了“取消”按钮。 |
标准字段验证错误
| 返回代码 | 说明 |
|---|---|
|
所有对话框常见的错误都位于OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN范围内。 此值允许应用程序测试标准消息，以便向用户显示错误消息。 |
|
指向传递到函数的 OLEUIXXX 结构的指针为 NULL。 |
|
对 OLEUIXXX 结构的读取或写入访问权限不足。 |
|
cbstruct 值不正确。 |
|
hWndOwner 值无效。 |
|
lpszCaption 值无效。 |
|
lpfnHook 值无效。 |
|
hInstance 值无效。 |
|
lpszTemplate 值无效。 |
|
hResource 值无效。 |
初始化错误
| 返回代码 | 说明 |
|---|---|
|
找不到对话框模板。 |
|
无法加载对话框模板。 |
|
对话框初始化失败。 |
|
对 LocalAlloc 或标准 IMalloc 分配器的调用失败。 |
|
对 GlobalAlloc 或标准 IMalloc 分配器的调用失败。 |
|
无法从库中为本地化资源调用 LoadString。 |
|
对标准 IMalloc 分配器的调用失败。 |
函数特定错误
| 返回代码 | 说明 |
|---|---|
|
所有对话框常见的错误都位于OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN范围内。 此值允许应用程序测试标准消息，以便向用户显示错误消息。 |
|
clsid 值无效。 |
|
dvAspect 值无效。 此成员指定 对象的方面。 |
|
wFormat 值无效。 此成员指定 对象的数据格式。 |
|
字符串值 (例如 lpszUserType 或 lpszDefLabel) 无效。 |
注解
OleUIConvert 通过遍历注册表并在可读键和 ReadWritable 键中查找条目，使用对象类填充“ 转换 ”对话框的列表框。 在其可读键中包含原始类的默认文件格式的每个类都会添加到“转换”列表，并且每个包含原始类的默认文件格式在其 ReadWritable 键中的类都会添加到“激活为”列表中。 选中“转换”单选按钮 (默认选择) 时，“ 转换 ”列表将显示在对话框的列表框中，并且选中“激活为”时会显示“ 激活为 ”列表。
请注意，仅当未指定CF_CONVERTONLY时，才能更改给定类的所有对象的类型。
仅当 OleUICanConvertOrActivateAs 返回S_OK时，才应向用户提供调用此函数的 convert 命令。
注意
oledlg.h 标头将 OLEUICONVERT 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | oledlg.h |
| Library | OleDlg.lib |
| DLL | OleDlg.dll |