IOpcPartSet：：CreatePart 方法 (msopc.h)
建立代表元件的元件物件，並將指標加入至物件的 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。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼/值 | 描述 |
|---|---|
|
此方法已成功。 |
|
name 參數為 NULL。 |
|
在 compressionOptions 參數中傳遞的值不是有效的 OPC_COMPRESSION_OPTIONS 列舉值。 |
|
具有指定元件名稱的元件已存在於目前的套件中。 |
|
內容類型不符合 RFC 2616 中指定的有效媒體類型規則：HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) 和 OPC。 |
|
元件的內容類型與 OPC、 ECMA-376 第 2 部分 () 中指定的預期內容類型不同，或元件內容不符合元件的內容類型。 |
|
來自套件耗用量錯誤群組的 HRESULT 錯誤碼。 |
|
來自元件 URI 錯誤群組的 HRESULT 錯誤碼。 |
備註
建立元件物件並將其指標新增至集合時，它會在封裝串行化時串行化它所代表的元件。
這個方法無法建立代表關聯性部分的元件物件。
如果在建立 part 物件之前壓縮元件內容，請在 compressionOptions 參數中傳遞OPC_COMPRESSION_NONE值。
已壓縮的部分內容不會大幅壓縮。
IOpcPart 可讓您存取元件的屬性。 如需這些屬性的詳細資訊，請參閱 元件概觀 和 IOpcPart 主題。
執行緒安全性
封裝物件不是安全線程。
如需詳細資訊，請參閱使用封裝 API 使用者入門。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | msopc.h |
另請參閱
外部資源
概觀
參考