enumeración OPC_READ_FLAGS (msopc.h)

Artículo
02/29/2024

Describe la configuración de lectura para almacenar en caché los componentes del paquete y validarlos con los requisitos de conformidad de 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;

Constantes


`OPC_READ_DEFAULT` Valor: 0 Valide un componente de paquete con los requisitos de conformidad de OPC cuando se acceda al componente. Para obtener más información sobre la validación de conformidad de OPC , vea Comentarios. Cuando se realiza la validación en el acceso, cualquier método puede devolver errores de validación de OPC .
`OPC_VALIDATE_ON_LOAD` Valor: 0x1 Valide todos los componentes del paquete en función de los requisitos de conformidad de OPC cuando se cargue un paquete. Para obtener más información sobre la validación de conformidad de OPC , vea Comentarios. Si esta configuración está habilitada, los costos de rendimiento para cargar y validar los componentes del paquete se pagan cuando el paquete se carga por primera vez.
`OPC_CACHE_ON_ACCESS` Valor: 0x2 Almacenar en caché los datos de componentes de paquete descomprimidos como un archivo temporal al acceder al componente por primera vez. Cuando se accede repetidamente a un componente de paquete, este almacenamiento en caché reduce la sobrecarga porque los datos del componente se descomprimen una vez para la primera lectura en lugar de una vez para cada operación de lectura.

Comentarios

Si se establecen las marcas de OPC_CACHE_ON_ACCESS y OPC_VALIDATE_ON_LOAD lectura, todos los componentes del paquete se descomprimen y almacenan en caché cuando se carga un paquete.

Las API de empaquetado no usan la característica de propiedades principales de OPC ; por lo tanto, las API de empaquetado no validan los requisitos principales de las propiedades enumeradas en la tabla H-9 del OPC . Para obtener más información sobre los requisitos de conformidad de OPC , vea 1ª edición, Parte 2: Convenciones de empaquetado abierto en ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Importante Las partes se pueden leer repetidamente desde la secuencia en cualquier momento, independientemente de las marcas de lectura establecidas. Por ejemplo, cuando se guarda un paquete, se puede acceder a las relaciones a las que se ha accedido previamente en un elemento Relationships del paquete original para conservar la compatibilidad de marcado.