iOpcPartUri：：GetSourceUri 方法 (msopc.h)
取得儲存在關聯性元件中的關聯性來源 URI。 目前的元件 URI 物件代表該關聯性元件的元件名稱。
語法
HRESULT GetSourceUri(
[out, retval] IOpcUri **sourceUri
);
參數
[out, retval] sourceUri
OPC URI 物件的 IOpcUri 介面指標，代表儲存在關聯性部分之關聯性來源的 URI。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼/值 | 描述 |
|---|---|
|
此方法已成功。 |
|
sourceUri 參數為 NULL。 |
|
需要關聯性元件的元件名稱，但元件名稱不是關聯性元件的元件名稱。
如需關聯性元件之元件名稱的詳細資訊，請參閱 OPC。 |
|
CreateUri 函式中的 HRESULT 錯誤碼。 |
|
來自 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 的支援
此方法的行為和效能在所有支援的 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 |
另請參閱
外部資源
概觀
參考