OleUIChangeSourceW 函数 (oledlg.h)
调用“ 更改源 ”对话框,允许用户更改链接的源。
语法
UINT OleUIChangeSourceW(
[in] LPOLEUICHANGESOURCEW unnamedParam1
);
参数
[in] unnamedParam1
指向此对话框的传入 OLEUICHANGESOURCE 结构的指针。
返回值
标准成功/错误定义
返回代码 | 说明 |
---|---|
|
未知故障 (未使用的) 。 |
|
用户按下了“确定”按钮。 |
|
无错误,与 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范围内。 此值允许应用程序测试标准消息,以便向用户显示错误消息。 |
|
lpOleUILinkContainer 值为 NULL。 |
|
lpOleUILinkContainer 值无效。 |
|
lpszFrom 值不是 NULL。 |
|
lpszTo 值不是 NULL。 |
|
lpszDisplayName 或 nFileLength 值无效,或者无法检索链接源。 |
|
nFilename 值错误。 |
注解
“更改源”对话框本身不会更改链接 源 。 相反,由调用方使用返回的文件和项字符串更改链接源。 “ 编辑链接 ”对话框通常为调用方执行此操作。
注意
oledlg.h 标头将 OLEUICHANGESOURCE 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oledlg.h |
Library | OleDlg.lib |
DLL | OleDlg.dll |