通过

OleUIPromptUserA 函数 (oledlg.h)

  • 项目

显示具有指定模板的对话框，并返回用户) (按钮标识符的响应。 此函数用于显示 OLE 警告消息，例如类未注册。

语法

int OleUIPromptUserA(
  [in] int  nTemplate,
  [in] HWND hwndParent,
       ...  
);

参数

[in] nTemplate

要显示的对话框的资源编号。 请参阅“备注”。

[in] hwndParent

对话框的父窗口的句柄。

...

可选。 对话框的标题，后跟对话框的静态控件 (IDC_PU_TEXT) 格式字符串的参数列表。 调用方必须确保传递正确的参数数量和类型。

返回值

标准成功/错误定义

返回代码 说明
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范围内。 此值允许应用程序测试标准消息，以便向用户显示错误消息。

注解

以下对话框模板在 Windows 界面指南--设计软件指南中定义。 nTemplate 参数必须是当前定义的资源，但是，可以将其他模板添加到 prompt.dlg。

IDD_LINKSOURCEUNAVAILABLE 
IDD_CANNOTUPDATELINK 
IDD_SERVERNOTREG 
IDD_CANNOTRESPONDVERB 
IDD_SERVERNOTFOUND

注意

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

要求

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