Метод IXpsOMPackageWriter::AddResource (xpsobjectmodel.h)
Создает новый ресурс части в пакете.
Синтаксис
HRESULT AddResource(
[in] IXpsOMResource *resource
);
Параметры
[in] resource
Интерфейс IXpsOMResource ресурса части, который будет добавлен в пакет в качестве новой части. Типы ресурсов, которые могут быть переданы в этом параметре, см. в разделе Примечания.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Ресурс с тем же именем, что и ресурс, на который ссылается ресурс , уже добавлен в поток или нет связи, включающей ресурс, на который ссылается ресурс.
После возврата E_INVALIDARG поток или файл перестают быть допустимыми, а функция Close вернет 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 |