IOpcRelationship::GetTargetUri 方法 (msopc.h)

取得關聯性目標的 URI。

語法

HRESULT GetTargetUri(
  [out, retval] IUri **targetUri
);

參數

[out, retval] targetUri

URI 之 IUri 介面的指標,表示關聯性目標的 URI。

如果關聯性目標是內部的,則目標是一部分,而目標的 URI 會相對於來源元件的 URI。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
targetUri 參數為 NULL

備註

尋找部分興趣的明確方式是使用關聯性類型。

尋找感興趣的部分需要數個步驟。 如需尋找元件的詳細資訊,請參閱 元件概觀尋找核心屬性元件

若要判斷關聯性的目標是否為內部或外部,請呼叫 GetTargetUri 方法。

如果關聯性目標是內部的,則目標為一部分。

如果關聯性目標是一部分, targetUri 中的 URI 會相對於關聯性來源的 URI。

如果關聯性目標為元件,請從 GetSourceUri 方法的 sourceUri 參數中收到的 IOpcUri 介面指標呼叫 IOpcUri::CombinePartUri 方法,以形成元件名稱。 使用 targetUri 中收到的相對 URI 做為 IOpcUri::CombinePartUri 呼叫的輸入參數。 如需範例,請參閱 從目標 URI 解析元件名稱

如需關聯性的詳細資訊,請參閱 開放式封裝慣例基本概念ECMA-376 OpenXML,第 1 版,第 2 部分:開放式封裝慣例 (OPC)

執行緒安全性

封裝物件不是安全線程。

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

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 msopc.h

另請參閱

ECMA-376 OpenXML

外部資源

使用封裝 API 進行 使用者入門

IOpcRelationship

OPC_URI_TARGET_MODE

開放式封裝慣例基本概念

概觀

封裝 API 參考

封裝 API 範例

參考

關聯性概觀

從目標 URI 解析元件名稱