Поделиться через


Метод IOpcPartSet::CreatePart (msopc.h)

Создает объект part, представляющий часть, и добавляет указатель на интерфейс IOpcPart объекта в набор.

Синтаксис

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

Параметры

[in] name

Указатель на интерфейс IOpcPartUri объекта URI части, который представляет имя части.

Чтобы создать объект 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 Part 2), либо содержимое части не соответствует типу контента части.
Ошибка потребления пакета
Код ошибки HRESULT из группы ошибок потребления пакетов.
Ошибка URI части
Код ошибки HRESULT из группы ошибок URI части.

Комментарии

При создании объекта части и добавлении указателя на него в набор часть, которую он представляет, сериализуется при сериализации пакета.

Этот метод не может создать объект part, представляющий часть Relationships.

Если содержимое части сжимается до создания объекта part, передайте значение OPC_COMPRESSION_NONE в параметр compressionOptions .

Содержимое части, которое уже сжато, не будет сжиматься значительно больше.

IOpcPart предоставляет доступ к свойствам части. Дополнительные сведения об этих свойствах см. в статьях Общие сведения о частях и IOpcPart .

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в статье начало работы с помощью API упаковки.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header msopc.h

См. также раздел

ECMA-376 OpenXML

Внешние ресурсы

начало работы с помощью API упаковки

IOpcFactory::CreatePartUri

IOpcPartSet

OPC_COMPRESSION_OPTIONS

Разделы общих сведений

Справочник по API упаковки

Примеры API упаковки

Ошибки упаковки

Общие сведения о компонентах

RFC 2616: HTTP/1.1

Справочные материалы