OPC_READ_FLAGS Enumeration (msopc.h)

Artikel
02/29/2024

Beschreibt die Leseeinstellungen für das Zwischenspeichern von Paketkomponenten und deren Überprüfung anhand der Anforderungen an ecma-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Syntax

typedef enum __MIDL___MIDL_itf_msopc_0000_0002_0004 {
  OPC_READ_DEFAULT = 0,
  OPC_VALIDATE_ON_LOAD = 0x1,
  OPC_CACHE_ON_ACCESS = 0x2
} OPC_READ_FLAGS;

Konstanten


`OPC_READ_DEFAULT` Wert: 0 Überprüfen Sie eine Paketkomponente anhand der OPC-Konformitätsanforderungen , wenn auf die Komponente zugegriffen wird. Weitere Informationen zur OPC-Konformitätsüberprüfung finden Sie unter Hinweise. Wenn die Überprüfung für den Zugriff durchgeführt wird, können OPC-Validierungsfehler von jeder Methode zurückgegeben werden.
`OPC_VALIDATE_ON_LOAD` Wert: 0x1 Überprüfen Sie alle Paketkomponenten anhand der OPC-Konformitätsanforderungen , wenn ein Paket geladen wird. Weitere Informationen zur OPC-Konformitätsüberprüfung finden Sie unter Hinweise. Wenn diese Einstellung aktiviert ist, werden die Leistungskosten für das Laden und Überprüfen von Paketkomponenten bezahlt, wenn das Paket zum ersten Mal geladen wird.
`OPC_CACHE_ON_ACCESS` Wert: 0x2 Speichern Sie dekomprimierte Paketkomponentendaten als temporäre Datei, wenn Sie zum ersten Mal auf die Komponente zugreifen. Wenn wiederholt auf eine Paketkomponente zugegriffen wird, reduziert diese Zwischenspeicherung den Mehraufwand, da die Komponentendaten einmal für den ersten Lesevorgang dekomprimiert werden und nicht einmal für jeden Lesevorgang.

Hinweise

Wenn sowohl die OPC_CACHE_ON_ACCESS - als auch OPC_VALIDATE_ON_LOAD-Leseflags festgelegt sind, werden alle Paketkomponenten dekomprimiert und zwischengespeichert, wenn ein Paket geladen wird.

Die Paketerstellungs-APIs verwenden nicht das OPC-Kerneigenschaftenfeature. Daher werden die in Tabelle H-9 des OPC aufgeführten Haupteigenschaftenanforderungen nicht von den Verpackungs-APIs überprüft. Weitere Informationen zu OPC-Konformitätsanforderungen finden Sie unter 1. Ausgabe, Teil 2: Open Packaging Conventions in ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Wichtig Teile können jederzeit wiederholt aus dem Stream gelesen werden, unabhängig davon, welche Leseflags festgelegt sind. Wenn beispielsweise ein Paket gespeichert wird, kann erneut auf Beziehungen in einem Beziehungsteil im ursprünglichen Paket zugegriffen werden, um die Markupkompatibilität zu erhalten.