IOpcUri：：GetRelativeUri 方法 (msopc.h)

形成指定部分的相對 URI，相對於目前 OPC URI 物件所代表的 URI。

語法

HRESULT GetRelativeUri(
  [in]          IOpcPartUri *targetPartUri,
  [out, retval] IUri        **relativeUri
);

參數

[in] targetPartUri

元件 URI 物件的 IOpcPartUri 介面指標，代表相對 URI 格式的元件名稱。

[out, retval] relativeUri

相對於目前 OPC URI 物件的 URI 之 IUri 介面指標。

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	至少其中一個 targetPartUri， 而 relativePartUri 參數為 NULL。
CreateUri 函式錯誤	CreateUri 函式的 HRESULT 錯誤碼。
WinINet 錯誤	來自 WinINet API 的 HRESULT 錯誤碼。

備註

範例輸入和輸出：

輸入 IOpcPartUri 代表	目前的 IOpcUri 代表	傳回的相對 IUri 代表
/mydoc/markup/page.xml	/mydoc/markup/picture.jpg	picture.jpg
/mydoc/markup/page.xml	/mydoc/picture.jpg	../picture.jpg
/mydoc/markup/page.xml	/mydoc/images/pictures.jpg	../images/pictures.jpg

 

舊版 Windows 的支援

此方法的行為和效能在所有支援的 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

另請參閱

使用封裝 API 使用者入門

IOpcUri

概觀

封裝 API 參考

封裝 API 範例

封裝錯誤

適用於 Windows Vista 的平臺更新

參考