Метод IXpsOMObjectFactory::CreateDocumentStructureResource (xpsobjectmodel.h)

Статья
12/22/2023

Создает интерфейс IXpsOMDocumentStructureResource , который предоставляет доступ к потоку ресурсов структуры документа.

Синтаксис

HRESULT CreateDocumentStructureResource(
  [in]          IStream                         *acquiredStream,
  [in]          IOpcPartUri                     *partUri,
  [out, retval] IXpsOMDocumentStructureResource **documentStructureResource
);

Параметры

[in] acquiredStream

Интерфейс IStream только для чтения, связанный с этим ресурсом. Этот параметр не должен иметь значение NULL.

Важно Рассматривать этот поток как объект Single-Threaded Apartment (STA); не вводите его повторно.

[in] partUri

Интерфейс IOpcPartUri , содержащий имя части, назначаемой этому ресурсу. Этот параметр не должен иметь значение NULL.

[out, retval] documentStructureResource

Указатель на новый интерфейс IXpsOMDocumentStructureResource .

Возвращаемое значение

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа XPS.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	параметр acquiredStream, partUri или documentStructureResource имеет значение NULL.

Часть DocumentStructure документа XPS содержит структуру документа, которая вместе с частями StoryFragments определяет порядок чтения каждого элемента, отображаемого на фиксированных страницах документа. Этот интерфейс позволяет программе считывать XML-содержимое части DocumentStructure, а также заменять XML-содержимое части DocumentStructure.

Часть DocumentStructure содержит платформу документов и структуру, описывающую общий порядок чтения документа. Порядок чтения упорядочен в семантические блоки, называемые историями. Истории являются логическими единицами документа так же, как статьи являются единицами в журнале. Истории состоят из одной или нескольких частей StoryFragments.

Части StoryFragments содержат разметку структуры содержимого, которая определяет семантические блоки истории, такие как абзацы и таблицы, составляющие содержимое истории.

Содержимое частей DocumentStructure и StoryFragments описано в спецификации документа XML.

Требования


Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	xpsobjectmodel.h