IOpcUri：：CombinePartUri 方法 (msopc.h)

形成指定之相對 URI 所參考之元件的元件名稱。元件的指定相對 URI 會根據表示為目前 OPC URI 物件的 URI 解析。

語法

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

[in] relativeUri

部分相對 URI 之 IUri 介面的指標。

若要形成代表元件名稱的元件 URI 物件，此輸入 URI 會根據以目前 OPC URI 物件表示的 URI 解析。因此，輸入 URI 必須相對於目前 OPC URI 物件所代表的 URI。

此 URI 可能包含片段元件;不過，將會忽略片段，而且不會包含在要形成的部分名稱中。片段元件前面會加上 '#'，如 RFC 3986：URI 一般語法中所述。

[out, retval] combinedUri

代表元件名稱之元件 URI 物件的 IOpcPartUri 介面指標。

元件 URI 物件是由解析 relativeUri 中的相對 URI，根據目前 OPC URI 物件所代表的 URI 來形成。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼/值	描述
S_OK	此方法已成功。
E_FAIL	CoInternetCombineUrl函式傳回了不正確大小。
E_POINTER	至少其中一個 relativeUri，而 combinedUri 參數為 Null。
E_UNEXPECTED	CoInternetCombineUrl函式所需的緩衝區大小意外變更。
OPC_E_NONCONFORMING_URI 0x80510001	元件名稱不符合 OPC 標準中指定的規則。
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	元件名稱不可以是絕對 URI。絕對 URI 以架構元件開頭，後面接著「：」，如 RFC 3986：URI 一般語法中所述。
CoInternetCombineUrl 函式錯誤	來自 CoInternetCombineUrl函式的HRESULT錯誤碼。
CreateUri 函式錯誤	CreateUri函式的HRESULT錯誤碼。
WinINet 錯誤	來自 WinINet API 的HRESULT錯誤碼。

範例輸入和輸出：

如需如何使用這個方法來協助解析元件名稱的詳細資訊，請參閱從目標 URI 解析元件名稱。

此方法的行為和效能在所有支援的 Windows 版本上都相同。如需詳細資訊，請參閱使用封裝 API 和 Windows Vista 平臺更新消費者入門。

封裝物件不是安全線程。

如需詳細資訊，請參閱使用封裝 API 消費者入門。


最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msopc.h