共用方式為


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
至少有一個 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 版本上都相同。 如需詳細資訊,請參閱使用封裝 API 和適用於 Windows Vista 的平臺更新 使用者入門。

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊,請參閱使用封裝 API 使用者入門

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [僅限桌面]
目標平台 Windows
標頭 msopc.h

另請參閱

CreateUri

ECMA-376 OpenXML

外部資源

使用封裝 API 使用者入門

IOpcFactory

概觀

封裝 API 程式設計指南

封裝 API 參考

封裝 API 範例

封裝錯誤

元件概觀

Windows Vista 的平臺更新

RFC 3986:URI 一般語法

參考