IOpcFactory::CreatePartUri 方法(msopc.h)

创建表示部件名称的部件 URI 对象。

Syntax

HRESULT CreatePartUri(
  [in]          LPCWSTR     pwzUri,
  [out, retval] IOpcPartUri **partUri
);

参数

[in] pwzUri

一个 URI,表示部件相对于包含它的包的根目录的位置。

[out, retval] partUri

指向部件 URI 对象的 IOpcPartUri 接口的指针。 此对象表示派生自 pwzUri 中传递的 URI 的部件名称。

部件名称必须符合 OPC 中指定的语法。

返回值

该方法返回 HRESULT。 可能的值包括但不限于下表中的值。

返回代码/值 Description
S_OK
方法成功。
E_POINTER
至少有一个 pwzUripartUri 参数为 NULL
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能为空字符串“”。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能为“/”。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能以“//”开头。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能以“/”结尾。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能以“.”结尾。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能包含以“.”结尾的任何段。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能有片段组件。 片段组件前面有一个“#”字符,如 RFC 3986:URI 泛型语法中所述。
OPC_E_NONCONFORMING_URI
0x80510001
部件名称不能是关系部件的名称,该部分指示另一个关系部件作为其包含的关系的来源。
OPC_E_RELATIVE_URI_REQUIRED
0x80510002
部件名称不能是绝对 URI。 绝对 URI 以架构组件开头,后跟“:”,如 RFC 3986:URI 泛型语法中所述。
CreateUri 函数错误
CreateUri 函数中的 HRESULT 错误代码。
WinINet 错误
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

另请参阅

CreateUri

ECMA-376 OpenXML

外部资源

打包 API 入门

IOpcFactory

概述

打包 API 编程指南

打包 API 参考

打包 API 示例

打包错误

部件概述

适用于 Windows Vista 的平台更新

RFC 3986:URI 泛型语法

引用