Метод 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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
Возвращаемый код/значение | Описание |
---|---|
|
Метод выполнен успешно. |
|
Параметр name имеет значение NULL. |
|
Значение, переданное в параметре compressionOptions, не является допустимым значением перечисления OPC_COMPRESSION_OPTIONS . |
|
Часть с указанным именем уже существует в текущем пакете. |
|
Тип контента не соответствует правилам для допустимого типа мультимедиа, указанным в RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) и OPC. |
|
Либо тип контента части отличается от ожидаемого типа контента (указанный в OPC, ECMA-376 Part 2), либо содержимое части не соответствует типу контента части. |
|
Код ошибки HRESULT из группы ошибок потребления пакетов. |
|
Код ошибки HRESULT из группы ошибок URI части. |
Комментарии
При создании объекта части и добавлении указателя на него в набор часть, которую он представляет, сериализуется при сериализации пакета.
Этот метод не может создать объект part, представляющий часть Relationships.
Если содержимое части сжимается до создания объекта part, передайте значение OPC_COMPRESSION_NONE в параметр compressionOptions .
Содержимое части, которое уже сжато, не будет сжиматься значительно больше.
IOpcPart предоставляет доступ к свойствам части. Дополнительные сведения об этих свойствах см. в статьях Общие сведения о частях и IOpcPart .
Потокобезопасность
Объекты упаковки не являются потокобезопасны.
Дополнительные сведения см. в статье начало работы с помощью API упаковки.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 7 [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
Целевая платформа | Windows |
Header | msopc.h |
См. также раздел
Внешние ресурсы
начало работы с помощью API упаковки
Разделы общих сведений
Справочные материалы