IOpcPartSet::GetPart 方法 (msopc.h)

取得元件物件,代表集合中的指定元件。

語法

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

參數

[in] name

代表元件之元件 URI 物件之 IOpcPartUri 介面的指標,代表元件的元件名稱。

[out, retval] part

代表具有指定之元件名稱之元件的 IOpcPart 指標。

傳回值

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

傳回碼/值 描述
S_OK
此方法已成功。
E_POINTER
name 參數為 NULL
OPC_E_NO_SUCH_PART
0x80510018
指定的元件不存在。
套件耗用量錯誤
來自套件耗用量錯誤群組HRESULT 錯誤碼。
元件 URI 錯誤
來自元件 URI 錯誤群組HRESULT 錯誤碼。

備註

若要擷取代表特定部分之 part 物件的 IOpcPart 介面指標,請呼叫 PartExists 方法並傳入元件名稱,以確認元件已在集合中表示。 如果是,請呼叫 GetPart 方法,並傳入元件名稱以擷取 IOpcPart 介面指標。

如果元件 URI 物件代表關聯性元件的元件名稱,這個方法將會失敗,因為集合中不包含關聯性元件。

IOpcPart 介面可讓您存取元件的屬性。 如需這些屬性的詳細資訊,請參閱 元件概觀IOpcPart

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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

另請參閱

使用封裝 API 使用者入門

IOpcPartSet

概觀

封裝 API 參考

封裝 API 範例

封裝錯誤

元件概觀

參考