IOpcFactory-Schnittstelle (msopc.h)

Artikel
03/04/2024

Erstellt Verpackungs-API-Objekte und bietet Unterstützung für das Speichern und Laden von Paketen. Objekte, die von IOpcFactory-Schnittstellenmethoden erstellt werden, bieten Unterstützung für das Erstellen, Auffüllen, Ändern und digitales Signieren von Paketen.

Vererbung

Die IOpcFactory-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcFactory verfügt auch über folgende Membertypen:

Methoden

Die IOpcFactory-Schnittstelle verfügt über diese Methoden.


IOpcFactory::CreateDigitalSignatureManager Erstellt ein Digitales Signatur-Manager-Objekt für ein Paketobjekt.
IOpcFactory::CreatePackage Erstellt ein Paketobjekt, das ein leeres Paket darstellt.
IOpcFactory::CreatePackageRootUri Erstellt ein OPC-URI-Objekt, das den Stamm eines Pakets darstellt.
IOpcFactory::CreatePartUri Erstellt ein Part-URI-Objekt, das einen Teilenamen darstellt.
IOpcFactory::CreateStreamOnFile Erstellt einen Stream über einer Datei.
IOpcFactory::ReadPackageFromStream Deserialisiert Paketdaten aus einem Stream und erstellt ein Paketobjekt, das das zu lesende Paket darstellt.
IOpcFactory::WritePackageToStream Serialisiert ein Paket, das durch ein Paketobjekt dargestellt wird.

Hinweise

Verwenden Sie keinen Stream, um Paketdaten zu serialisieren, wenn derselbe Stream zum Deserialisieren eines Pakets verwendet wird. Der Versuch, dies zu tun, kann zu einem nicht definierten Verhalten führen.

Um die Paket-API zu verwenden, muss das Paket einem ZIP-Archiv zugeordnet werden, wie in ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC) angegeben.

Um eine Factory zu erstellen, die die IOpcFactory-Schnittstelle implementiert, rufen Sie die Funktion CoCreateInstance auf . Diese Factory ist nicht an ein bestimmtes Paket- oder Verpackungs-API-Objekt gebunden und kann für die Lebensdauer der Anwendung verwendet werden. Beispielcode zum Erstellen einer Factory, die IOpcFactory implementiert, finden Sie im Erste Schritte mit der Paket-API.

IOpcFactory-Unterstützung für frühere Versionen von Windows

Wenn eine Anwendung versucht, eine nicht unterstützte IOpcFactory-Methode zu verwenden, wird der E_NOTIMPL Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Erste Schritte mit der Paketerstellungs-API und Plattformupdate für Windows Vista.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h