msopc.h (iOpcRelationshipSelector 介面)

發行項
02/29/2024

表示如何從 [關聯性] 部分選取要參考的簽署關聯性。

繼承

IOpcRelationshipSelector 介面繼承自 IUnknown 介面。 IOpcRelationshipSelector 也有下列類型的成員：

方法

IOpcRelationshipSelector 介面具有這些方法。


IOpcRelationshipSelector：：GetSelectionCriterion 取得字串，用來選取要參考以進行簽署的關聯性。
IOpcRelationshipSelector：：GetSelectorType 取得值，描述如何選取要參考的關聯性以進行簽署。

備註

若要建立 IOpcRelationshipSelector 介面指標，請呼叫 IOpcRelationshipSelectorSet：：Create 方法。

若要存取 IOpcRelationshipSelector，請呼叫 IOpcRelationshipSelectorEnumerator：：GetCurrent 方法。

使用 IOpcRelationshipSelector 介面方法來選取簽署的關聯性。如果關聯性的類型或標識符符合呼叫 GetSelectionCriterion 方法所擷取的字串，則會選取關聯性。此字串是關聯性類型或關聯性標識碼。呼叫 GetSelectorType 方法來取得 OPC_RELATIONSHIP_SELECTOR 值，以判斷字串是關聯性類型還是標識符。若要存取這些關聯性屬性，請呼叫 IOpcRelationship：：GetRelationshipType 和 IOpcRelationship：：GetId 方法。

下表顯示 OPC_RELATIONSHIP_SELECTOR 值如何對應至關聯性類型和關聯性標識碼屬性。

OPC_RELATIONSHIP_SELECTOR 價值	Relationship 屬性	Description
OPC_RELATIONSHIP_SELECT_BY_TYPE	關聯性類型	選取具有符合 selectionCriterion 字串之關聯性類型的關聯性。
OPC_RELATIONSHIP_SELECT_BY_ID	關聯性標識碼	選取具有符合 selectionCriterion 字串之關聯性標識碼的關聯性。

產生簽章時，介面所提供的關聯性選取資訊會在簽章的 XML 標記中串行化 (簽章標記) 。在簽章標記中，這項資訊是由第 12 節中指定的 RelationshipReference 和 RelationshipGroupReference 元素表示。 ECMA-376 OpenXML，第 1 版，第 2 部分：開啟封裝慣例 (OPC) 。下表顯示元素如何對應至關聯性屬性和 OPC_RELATIONSHIP_SELECTOR 值。

封裝簽章專案	Relationship 屬性	OPC_RELATIONSHIP_SELECTOR 價值
RelationshipGroupReference	關聯性類型	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	關聯性標識碼	OPC_RELATIONSHIP_SELECT_BY_ID

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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