énumération OPC_READ_FLAGS (msopc.h)

Article
03/06/2024

Décrit les paramètres de lecture pour la mise en cache des composants de package et leur validation par rapport à ECMA-376 OpenXML, 1ère édition, partie 2 : Exigences de conformité opc (Open Packaging Conventions).

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;

Constantes


`OPC_READ_DEFAULT` Valeur : 0 Validez un composant de package par rapport aux exigences de conformité OPC lors de l’accès au composant. Pour plus d’informations sur la validation de la conformité OPC , consultez Remarques. Lorsque la validation est effectuée sur l’accès, les erreurs de validation OPC peuvent être retournées par n’importe quelle méthode.
`OPC_VALIDATE_ON_LOAD` Valeur : 0x1 Validez tous les composants de package par rapport aux exigences de conformité OPC lors du chargement d’un package. Pour plus d’informations sur la validation de la conformité OPC , consultez Remarques. Si ce paramètre est activé, les coûts de performances liés au chargement et à la validation des composants du package sont payés lors du premier chargement du package.
`OPC_CACHE_ON_ACCESS` Valeur : 0x2 Mettre en cache les données du composant de package décompressé sous forme de fichier temporaire lors de l’accès au composant pour la première fois. Lorsqu’un composant de package est consulté à plusieurs reprises, cette mise en cache réduit la surcharge, car les données du composant sont décompressées une fois pour la première lecture au lieu d’une seule fois pour chaque opération de lecture.

Remarques

Si les indicateurs de lecture OPC_CACHE_ON_ACCESS et OPC_VALIDATE_ON_LOAD sont définis, tous les composants du package sont décompressés et mis en cache lors du chargement d’un package.

Les API d’empaquetage n’utilisent pas la fonctionnalité de propriétés principales OPC ; par conséquent, les exigences en matière de propriétés principales répertoriées dans le tableau H-9 de l’OPC ne sont pas validées par les API d’empaquetage. Pour plus d’informations sur les exigences de conformité OPC , consultez 1ère édition, Partie 2 : Open Packaging Conventions in ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Important Les parties peuvent être lues à plusieurs reprises à partir du flux à tout moment, quels que soient les indicateurs de lecture définis. Par exemple, lorsqu’un package est enregistré, les relations précédemment consultées dans une partie Relations du package d’origine peuvent être à nouveau accessibles pour préserver la compatibilité du balisage.