iOpcFactory：：CreatePartUri 方法 (msopc.h)

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

语法

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

[in] pwzUri

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

[out, retval] partUri

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

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

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

返回代码/值	说明
S_OK	方法成功。
E_POINTER	pwzUri 和 partUri 参数中至少有一个为 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 版本上都是相同的。有关详细信息，请参阅使用打包 API 入门和适用于 Windows Vista 的平台更新。

打包对象不是线程安全的。

有关详细信息，请参阅打包 API 的入门。

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [仅限桌面应用]
目标平台	Windows
标头	msopc.h