IOpcPartSet::P artExists 方法 (msopc.h)

取得值,這個值表示指定的元件是否以集合中的 part 物件表示。

語法

HRESULT PartExists(
  [in]          IOpcPartUri *name,
  [out, retval] BOOL        *partExists
);

參數

[in] name

IOpcPartUri 的指標,代表元件的元件名稱。

[out, retval] partExists

下列其中一個值:

意義
TRUE
具有指定元件名稱的元件會在集合中表示。
FALSE
具有指定元件名稱的元件未在集合中表示。

傳回值

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

傳回碼 描述
S_OK
此方法已成功。
E_POINTER
partExists 參數為 NULL
套件耗用量錯誤
來自套件耗用量錯誤群組HRESULT 錯誤碼。
元件 URI 錯誤
來自元件 URI 錯誤群組HRESULT 錯誤碼。

備註

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

如果表示的元件名稱是關聯性元件的名稱, 則 partExists 會收到 FALSE ,因為集合中不包含關聯性元件。

如果元件是在集合中表示,則元件存在於要讀取的封裝或要寫入的封裝中。

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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

另請參閱

使用封裝 API 使用者入門

IOpcPartSet

概觀

封裝 API 參考

封裝 API 範例

封裝錯誤

元件概觀

參考