IOpcPartSet::GetPart 方法 (msopc.h)
取得元件物件,代表集合中的指定元件。
語法
HRESULT GetPart(
[in] IOpcPartUri *name,
[out, retval] IOpcPart **part
);
參數
[in] name
代表元件之元件 URI 物件之 IOpcPartUri 介面的指標,代表元件的元件名稱。
[out, retval] part
代表具有指定之元件名稱之元件的 IOpcPart 指標。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼/值 | 描述 |
---|---|
|
此方法已成功。 |
|
name 參數為 NULL。 |
|
指定的元件不存在。 |
|
來自套件耗用量錯誤群組的 HRESULT 錯誤碼。 |
|
來自元件 URI 錯誤群組的 HRESULT 錯誤碼。 |
備註
若要擷取代表特定部分之 part 物件的 IOpcPart 介面指標,請呼叫 PartExists 方法並傳入元件名稱,以確認元件已在集合中表示。 如果是,請呼叫 GetPart 方法,並傳入元件名稱以擷取 IOpcPart 介面指標。
如果元件 URI 物件代表關聯性元件的元件名稱,這個方法將會失敗,因為集合中不包含關聯性元件。
IOpcPart 介面可讓您存取元件的屬性。 如需這些屬性的詳細資訊,請參閱 元件概觀 和 IOpcPart。
執行緒安全性
封裝物件不是安全線程。
如需詳細資訊,請參閱使用封裝 API 使用者入門。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | msopc.h |
另請參閱
概觀
參考