Метод IXpsOMPackageWriter::AddResource (xpsobjectmodel.h)

Статья
08/28/2023

Создает новый ресурс части в пакете.

Синтаксис

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

Параметры

[in] resource

Интерфейс IXpsOMResource ресурса части, который будет добавлен в пакет в качестве новой части. Типы ресурсов, которые могут быть переданы в этом параметре, см. в разделе Примечания.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Ресурс с тем же именем, что и ресурс, на который ссылается ресурс , уже добавлен в поток или нет связи, включающей ресурс, на который ссылается ресурс. После возврата E_INVALIDARG поток или файл перестают быть допустимыми, а функция Close вернет XPS_E_UNAVAILABLE_PACKAGE.
XPS_E_UNAVAILABLE_PACKAGE	Произошла серьезная ошибка, и содержимое XPS OM может быть неустранимо. Некоторые компоненты XPS OM могут по-прежнему использоваться, но только после проверки. Так как состояние модели XPS невозможно предсказать после возврата этой ошибки, все компоненты модели XPS должны быть освобождены и удалены.

Этот метод вызывает API упаковки . Сведения о возвращаемых значениях API упаковки см. в разделе Ошибки упаковки.

Интерфейс IXpsOMFontResource ресурса шрифта, который используется на текущей странице или на странице, которая уже была добавлена.
Интерфейс IXpsOMImageResource ресурса изображения, который используется на текущей странице или на странице, которая уже была добавлена.
Интерфейс IXpsOMColorProfileResource ресурса цветового профиля, который используется на текущей странице или на странице, которая уже была добавлена.
Интерфейс IXpsOMStoryFragmentsResource ресурса фрагментов истории, который используется на текущей странице или на странице, которая уже была добавлена.
Интерфейс IXpsOMDocumentStructureResource ресурса структуры документа, который используется в текущем документе или документе, который уже был добавлен.
Интерфейс IXpsOMSignatureBlockResource ресурса блока подписи, который используется в текущем документе или документе, который уже был добавлен.

Этот метод возвращает ошибку, если ресурс содержит одно из следующих компонентов:

Интерфейс IXpsOMRemoteDictionaryResource удаленного словаря ресурсов.
Интерфейс IXpsOMPrintTicketResource билета печати.
Интерфейс IXpsOMImageResource эскиза изображения.

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

Требования

Требование	Значение
Минимальная версия клиента	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