iOpcPartUri：：GetSourceUri 方法 (msopc.h)

取得儲存在關聯性元件中的關聯性來源 URI。目前的元件 URI 物件代表該關聯性元件的元件名稱。

語法

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

[out, retval] sourceUri

OPC URI 物件的 IOpcUri 介面指標，代表儲存在關聯性部分之關聯性來源的 URI。

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

傳回碼/值	描述
S_OK	此方法已成功。
E_POINTER	sourceUri 參數為 NULL。
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	需要關聯性元件的元件名稱，但元件名稱不是關聯性元件的元件名稱。如需關聯性元件之元件名稱的詳細資訊，請參閱 OPC。
CreateUri 函式錯誤	CreateUri 函式中的 HRESULT 錯誤碼。
WinINet 錯誤	來自 WinINet API 的 HRESULT 錯誤碼。

如果目前的元件 URI 物件代表儲存封裝關聯性 (“/_rels/.rels”) 的 Relationships 元件名稱， 則 sourceUri 中傳回的 OPC URI 物件將代表套件根 (“/”) 。

如果目前的元件 URI 物件不是關聯性元件的元件名稱，這個方法會失敗並出現 OPC_E_RELATIONSHIP_URI_REQUIRED 錯誤。 OPC 中會指定 Relationship 元件名稱的語法。

下表顯示這個方法所傳回的可能目前部分 URI 和來源 URI。

目前的元件 URI	目前元件 URI 描述	來源 URI	來源 URI 描述	傳回值
/mydoc/_rels/picture.jpg.rels	關聯性元件的元件名稱	/mydoc/picture.jpg	元件的部分名稱，該元件是儲存在目前元件 URI 物件所代表之關聯性元件中之關聯性的來源	S_OK
/_rels/.rels	關聯性元件的元件名稱	/	套件根目錄;儲存在目前元件 URI 物件所代表之關聯性元件中的關聯性來源	S_OK
/mydoc/image/chart1.jpg	不是關聯性元件之元件的元件名稱	未定義	未定義	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	不是關聯性元件之元件的元件名稱	未定義	未定義	OPC_E_RELATIONSHIP_URI_REQUIRED

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