IOpcPartSet：：CreatePart 方法 (msopc.h)

發行項
02/29/2024

建立代表元件的元件物件，並將指標加入至物件的 IOpcPart 介面至集合。

語法

HRESULT CreatePart(
  [in]          IOpcPartUri             *name,
  [in]          LPCWSTR                 contentType,
  [in]          OPC_COMPRESSION_OPTIONS compressionOptions,
  [out, retval] IOpcPart                **part
);

參數

[in] name

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

若要建立元件 URI 物件 (實作 IOpcPartUri 介面) 來代表元件的元件名稱，請呼叫 IOpcFactory：：CreatePartUri 方法。

[in] contentType

元件內容的媒體類型。

[in] compressionOptions

值，描述壓縮元件內容的方式。

[out, retval] part

代表元件之新 IOpcPart 的指標。

此參數不可為 NULL。

傳回值

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

傳回碼/值	描述
S_OK	此方法已成功。
E_POINTER	name 參數為 NULL。
E_INVALIDARG	在 compressionOptions 參數中傳遞的值不是有效的 OPC_COMPRESSION_OPTIONS 列舉值。
OPC_E_DUPLICATE_PART 0x8051000B	具有指定元件名稱的元件已存在於目前的套件中。
OPC_E_INVALID_CONTENT_TYPE 0x80510044	內容類型不符合 RFC 2616 中指定的有效媒體類型規則：HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) 和 OPC。
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	元件的內容類型與 OPC、 ECMA-376 第 2 部分 () 中指定的預期內容類型不同，或元件內容不符合元件的內容類型。
套件耗用量錯誤	來自套件耗用量錯誤群組的 HRESULT 錯誤碼。
元件 URI 錯誤	來自元件 URI 錯誤群組的 HRESULT 錯誤碼。

備註

建立元件物件並將其指標新增至集合時，它會在封裝串行化時串行化它所代表的元件。

這個方法無法建立代表關聯性部分的元件物件。

如果在建立 part 物件之前壓縮元件內容，請在 compressionOptions 參數中傳遞OPC_COMPRESSION_NONE值。

已壓縮的部分內容不會大幅壓縮。

IOpcPart 可讓您存取元件的屬性。如需這些屬性的詳細資訊，請參閱元件概觀和 IOpcPart 主題。

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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