Интерфейс IOpcFactory (msopc.h)

Статья
02/29/2024

Создает объекты API упаковки и обеспечивает поддержку сохранения и загрузки пакетов. Объекты, созданные методами интерфейса IOpcFactory , обеспечивают поддержку создания, заполнения, изменения и цифровой подписи пакетов.

Наследование

Интерфейс IOpcFactory наследуется от интерфейса IUnknown . IOpcFactory также имеет следующие типы элементов:

Методы

Интерфейс IOpcFactory содержит следующие методы.


IOpcFactory::CreateDigitalSignatureManager Создает объект диспетчера цифровых подписей для объекта пакета.
IOpcFactory::CreatePackage Создает объект пакета, представляющий пустой пакет.
IOpcFactory::CreatePackageRootUri Создает объект URI OPC, представляющий корень пакета.
IOpcFactory::CreatePartUri Создает объект URI части, представляющий имя части.
IOpcFactory::CreateStreamOnFile Создает поток по файлу.
IOpcFactory::ReadPackageFromStream Десериализует данные пакета из потока и создает объект пакета для представления считываемого пакета.
IOpcFactory::WritePackageToStream Сериализует пакет, представленный объектом пакета.

Не используйте поток для сериализации данных пакета, если тот же поток используется для десериализации пакета; Попытка сделать это может привести к неопределенному поведению.

Чтобы использовать API упаковки, пакет должен сопоставляться с ZIP-архивом, как указано в ecMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC) (EcMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).)

Чтобы создать фабрику, реализующую интерфейс IOpcFactory , вызовите функцию CoCreateInstance . Эта фабрика не привязана к какому-либо конкретному пакету или объекту API упаковки и может использоваться в течение времени существования приложения. Пример кода, демонстрирующий создание фабрики, реализующей IOpcFactory, см. в начало работы с API упаковки.

Поддержка IOpcFactory в предыдущих версиях Windows

Если приложение пытается использовать неподдерживаемый метод IOpcFactory , возвращается код ошибки E_NOTIMPL. Дополнительные сведения см. в разделах начало работы с ПОМОЩЬЮ API упаковки и Обновление платформы для Windows Vista.

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

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

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

Требования

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