OleUIObjectPropertiesA 函数（oledlg.h）

项目
11/20/2024

调用 对象属性 对话框，该对话框显示常规、视图以及链接有关对象的信息。

语法

UINT OleUIObjectPropertiesA(
  [in] LPOLEUIOBJECTPROPSA unnamedParam1
);

参数

[in] unnamedParam1

指向 OLEUIOBJECTPROPS 结构的指针。

返回值

标准成功/错误定义

返回代码	描述
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_OPERR_SUBPROPNULL	lpGP 或 lpVPNULL，或者 dwFlags，OPF_OBJECTISLINK，lpLPNULL。
OLEUI_OPERR_SUBPROPINVALID	lpGP、lpVP或 lpLP指向的结构的写入访问权限不足。
OLEUI_OPERR_PROPSHEETNULL	lpLP 值 NULL。
OLEUI_OPERR_PROPSHEETINVALID	lpGP、lpVP或 lpLP指向的结构的写入访问权限不足。
OLEUI_OPERR_SUPPROP	子链接属性指针（lpLP）NULL。
OLEUI_OPERR_PROPSINVALID	子链接属性指针的写入访问不足，lpLP。
OLEUI_OPERR_PAGESINCORRECT	lpPS 成员的某些子链接属性不正确。
OLEUI_OPERR_INVALIDPAGES	lpPS 成员的某些子链接属性不正确。
OLEUI_OPERR_NOTSUPPORTED	lpPS 成员的子链接属性不正确。
OLEUI_OPERR_DLGPROCNOTNULL	lpPS 成员的子链接属性不正确。
OLEUI_OPERR_LPARAMNOTZERO	lpPS 成员的子链接属性不正确。
OLEUI_GPERR_STRINGINVALID	字符串值（例如，lpszLabel 或 lplpszType）无效。
OLEUI_GPERR_CLASSIDINVALID	clsid 值无效。
OLEUI_GPERR_LPCLSIDEXCLUDEINVALID	ClsidExcluded 值无效。
OLEUI_GPERR_CBFORMATINVALID	wFormat 值的无效。
OLEUI_VPERR_METAPICTINVALID	hMetaPict 值无效。
OLEUI_VPERR_DVASPECTINVALID	dvAspect 值无效。
OLEUI_OPERR_PROPERTYSHEET	lpPS 值不正确。
OLEUI_OPERR_OBJINFOINVALID	lpObjInfo 值 NULL 或调用进程没有读取访问权限。
OLEUI_OPERR_LINKINFOINVALID	lpLinkInfo 值 NULL 或调用进程没有读取访问权限。

言论

OleUIObjectProperties 传递 OLEUIOBJECTPROPS 结构，该结构提供填写常规、视图和链接选项卡 对象属性 对话框的信息。

注意

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

要求

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