IOpcRelationshipSet：：CreateRelationship 方法 (msopc.h)

發行項
02/29/2024

建立代表指定關聯性的關聯性對象，然後將指標新增至物件的 IOpcRelationship 介面。

語法

HRESULT CreateRelationship(
  [in]          LPCWSTR             relationshipIdentifier,
  [in]          LPCWSTR             relationshipType,
  [in]          IUri                *targetUri,
  [in]          OPC_URI_TARGET_MODE targetMode,
  [out, retval] IOpcRelationship    **relationship
);

參數

[in] relationshipIdentifier

要表示為關聯性對象之關聯性的唯一標識符。若要使用隨機產生的標識碼，請將 NULL 傳遞至此參數。

有效的標識元符合 xsd：ID 的限制，這些限制記載於 W3C 建議的第 3.3.8 節標識碼、XML 架構第 2 部分：數據類型第二版 (http://www.w3.org/TR/xmlschema-2/#ID) 。

[in] relationshipType

關聯性類型，定義要表示為關聯性物件之關聯性的角色。

[in] targetUri

要表示為關聯性對象之關聯性目標的 URI。

如果 targetMode 中的值 是OPC_URI_TARGET_MODE_INTERNAL，則 target 是一部分，而且 URI 必須相對於關聯性的來源。

如果 targetMode 中的值 是OPC_URI_TARGET_MODE_EXTERNAL，則 target 是套件外部的資源，而且 URI 可能是絕對或相對於封裝的位置。

如需關聯性目標 URI 的詳細資訊，請參閱 OPC。

[in] targetMode

值，指出要以關聯性物件表示之關聯性的目標是否為封裝內部或外部。

[out, retval] relationship

代表關聯性之關聯物件的 IOpcRelationship 介面指標。

如果不需要新物件的指標，這個參數可以是 NULL 。

傳回值

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

傳回碼/值	描述
S_OK	此方法已成功。
E_INVALIDARG	在 targetMode 參數中傳遞的值不是有效的 OPC_URI_TARGET_MODE 列舉值。
E_POINTER	至少其中一個 relationshipType 和 targetUri 參數為 NULL。
OPC_E_DUPLICATE_RELATIONSHIP 0x80510013	目前套件中已經存在具有相同標識碼的關聯性。
OPC_E_INVALID_RELATIONSHIP_ID 0x80510010	關聯性的 Id 屬性不符合 OPC 中指定的規則。
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	targetUri 中的 URI 是絕對的，且 targetMode 中的值是OPC_URI_TARGET_MODE_INTERNAL。指定此目標模式時，目標的 URI 必須相對。
OPC_E_INVALID_RELATIONSHIP_TARGET 0x80510012	關聯性的目標屬性不符合 OPC 中指定的規則。
OPC_E_INVALID_RELATIONSHIP_TYPE 0x80510011	關聯性的 Type 屬性不符合 OPC 中指定的規則。
套件耗用量錯誤	來自套件耗用量錯誤群組的 HRESULT 錯誤碼。
元件 URI 錯誤	來自元件 URI 錯誤群組的 HRESULT 錯誤碼。

備註

建立關聯性物件並將它指標新增至集合時，它會在儲存封裝時儲存它所代表的關聯性。

IOpcRelationship 介面可讓您存取關聯性屬性。如需這些屬性的詳細資訊，請參閱關聯性概觀和 IOpcRelationship。

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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