通过

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_STANDARDMIN OLEUI_ERR_STANDARDMAX。 此值允许应用程序测试标准消息，以便向用户显示错误消息。
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_STANDARDMIN OLEUI_ERR_STANDARDMAX。 此值允许应用程序测试标准消息，以便向用户显示错误消息。
OLEUI_CTERR_CLASSIDINVALID
 clsid 值无效。
OLEUI_CTERR_DVASPECTINVALID
 dvAspect 值无效。 此成员指定对象的方面。
OLEUI_CTERR_CBFORMATINVALID
 wFormat 值无效。 此成员指定对象的数据格式。
OLEUI_CTERR_STRINGINVALID
 字符串值（例如，lpszUserType 或 lpszDefLabel）无效。

言论

OleUIConvert 通过遍历注册表并查找可读键和 ReadWritable 键中的条目，使用对象类填充 转换 对话框的列表框。 在可读键中包含原始类的默认文件格式的每个类都会添加到“转换”列表中，并将包含原始类的默认文件格式的每个类添加到“激活方式”列表中。 选中 转换 单选按钮时，对话框的列表框中会显示“转换”列表（默认选择），并且选中 激活为 时会显示“激活为”列表。

请注意，仅当未指定CF_CONVERTONLY时，才能更改给定类的所有对象的类型。

仅当 OleUICanConvertOrActivateAs 返回S_OK时，才应向用户提供调用此函数的 convert 命令。

注意

oledlg.h 标头将 OLEUICONVERT 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 oledlg.h
库 OleDlg.lib
DLL OleDlg.dll

另请参阅

OLEUICONVERT

OleUICanConvertOrActivateAs