共用方式為


IOpcRelationship::GetId 方法 (msopc.h)

取得關聯性的唯一標識碼。

語法

HRESULT GetId(
  [out, retval] LPWSTR *relationshipIdentifier
);

參數

[out, retval] relationshipIdentifier

關聯性的識別碼。

關聯性的識別碼是封裝的任意和本機,因此為 。

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

傳回值

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

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

備註

關聯性的標識碼不適用於尋找關聯性,因為它是封裝的任意和本機。

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

尋找元件需要數個步驟。 如需尋找元件的詳細資訊,請參閱 尋找核心屬性元件

這個方法會配置 關聯性Identifier 中所傳回字串所使用的記憶體。 如果方法成功,請呼叫 CoTaskMemFree 函式以釋放記憶體。

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

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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

另請參閱

ECMA-376 OpenXML

外部資源

尋找核心屬性元件

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

IOpcRelationship

IOpcRelationshipSet

開放式封裝慣例基本概念

概觀

封裝 API 參考

封裝 API 範例

參考

關聯性概觀

W3C 建議,XML 架構第 2 部分:數據類型第二版