创建表示部件名称的部件 URI 对象。
Syntax
HRESULT CreatePartUri(
[in] LPCWSTR pwzUri,
[out, retval] IOpcPartUri **partUri
);
参数
[in] pwzUri
一个 URI,表示部件相对于包含它的包的根目录的位置。
[out, retval] partUri
指向部件 URI 对象的 IOpcPartUri 接口的指针。 此对象表示派生自 pwzUri 中传递的 URI 的部件名称。
部件名称必须符合 OPC 中指定的语法。
返回值
该方法返回 HRESULT。 可能的值包括但不限于下表中的值。
| 返回代码/值 | Description |
|---|---|
|
方法成功。 |
|
至少有一个 pwzUri 和 partUri 参数为 NULL。 |
|
部件名称不能为空字符串“”。 |
|
部件名称不能为“/”。 |
|
部件名称不能以“//”开头。 |
|
部件名称不能以“/”结尾。 |
|
部件名称不能以“.”结尾。 |
|
部件名称不能包含以“.”结尾的任何段。 |
|
部件名称不能有片段组件。 片段组件前面有一个“#”字符,如 RFC 3986:URI 泛型语法中所述。 |
|
部件名称不能是关系部件的名称,该部分指示另一个关系部件作为其包含的关系的来源。 |
|
部件名称不能是绝对 URI。 绝对 URI 以架构组件开头,后跟“:”,如 RFC 3986:URI 泛型语法中所述。 |
|
CreateUri 函数中的 HRESULT 错误代码。 |
|
WinINet API 中的 HRESULT 错误代码。 |
注解
在以前的 Windows 版本上支持
此方法的行为和性能在所有受支持的 Windows 版本上都是相同的。 有关详细信息,请参阅 Windows Vista 的打包 API 和 平台更新入门。线程安全性
打包对象不是线程安全的。
有关详细信息,请参阅 打包 API 入门。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | 适用于 Windows Vista 的 Windows 7、带有 SP2 和平台更新的 Windows Vista [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | msopc.h |
另请参阅
外部资源
概述
引用