OleUIConvertA 函数 (oledlg.h)

调用标准“ 转换 ”对话框,允许用户更改单个指定对象的类型,或指定对象的类的所有 OLE 对象的类型。

语法

UINT OleUIConvertA(
  [in] LPOLEUICONVERTA unnamedParam1
);

参数

[in] unnamedParam1

指向包含用于初始化对话框的信息 的 OLEUICONVERT 结构的指针。

返回值

标准成功/错误定义

返回代码 说明
OLEUI_FALSE
未知故障 (未使用的) 。
OLEUI_OK
用户按下了“确定”按钮。
OLEUI_SUCCESS
无错误,与 OLEUI_OK 相同。
OLEUI_CANCEL
用户按下了“取消”按钮。
 

标准字段验证错误

返回代码 说明
OLEUI_ERR_STANDARDMIN
所有对话框常见的错误都位于OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN范围内。 此值允许应用程序测试标准消息,以便向用户显示错误消息。
OLEUI_ERR_STRUCTURENULL
指向传递到函数的 OLEUIXXX 结构的指针为 NULL
OLEUI_ERR_STRUCTUREINVALID
对 OLEUIXXX 结构的读取或写入访问权限不足。
OLEUI_ERR_CBSTRUCTINCORRECT
cbstruct 值不正确。
OLEUI_ERR_HWNDOWNERINVALID
hWndOwner 值无效。
OLEUI_ERR_LPSZCAPTIONINVALID
lpszCaption 值无效。
OLEUI_ERR_LPFNHOOKINVALID
lpfnHook 值无效。
OLEUI_ERR_HINSTANCEINVALID
hInstance 值无效。
OLEUI_ERR_LPSZTEMPLATEINVALID
lpszTemplate 值无效。
OLEUI_ERR_HRESOURCEINVALID
hResource 值无效。
 

初始化错误

返回代码 说明
OLEUI_ERR_FINDTEMPLATEFAILURE
找不到对话框模板。
OLEUI_ERR_LOADTEMPLATEFAILURE
无法加载对话框模板。
OLEUI_ERR_DIALOGFAILURE
对话框初始化失败。
OLEUI_ERR_LOCALMEMALLOC
LocalAlloc 或标准 IMalloc 分配器的调用失败。
OLEUI_ERR_GLOBALMEMALLOC
GlobalAlloc 或标准 IMalloc 分配器的调用失败。
OLEUI_ERR_LOADSTRING
无法从库中为本地化资源调用 LoadString。
OLEUI_ERR_OLEMEMALLOC
对标准 IMalloc 分配器的调用失败。
 

函数特定错误

返回代码 说明
OLEUI_ERR_STANDARDMAX
所有对话框常见的错误都位于OLEUI_ERR_STANDARDMAX OLEUI_ERR_STANDARDMIN范围内。 此值允许应用程序测试标准消息,以便向用户显示错误消息。
OLEUI_CTERR_CLASSIDINVALID
clsid 值无效。
OLEUI_CTERR_DVASPECTINVALID
dvAspect 值无效。 此成员指定 对象的方面。
OLEUI_CTERR_CBFORMATINVALID
wFormat 值无效。 此成员指定 对象的数据格式。
OLEUI_CTERR_STRINGINVALID
字符串值 (例如 lpszUserTypelpszDefLabel) 无效。

注解

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

另请参阅

OLEUICONVERT

OleUICanConvertOrActivateAs