enumerazione OPC_READ_FLAGS (msopc.h)

Articolo
02/29/2024

Vengono descritte le impostazioni di lettura per memorizzare nella cache i componenti del pacchetto e convalidarle in base ai requisiti di conformità ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Sintassi

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;

Costanti


`OPC_READ_DEFAULT` Valore: 0 Convalidare un componente del pacchetto in base ai requisiti di conformità OPC quando si accede al componente. Per altre informazioni sulla convalida della conformità OPC , vedere Osservazioni. Quando viene eseguita la convalida sull'accesso, gli errori di convalida OPC possono essere restituiti da qualsiasi metodo.
`OPC_VALIDATE_ON_LOAD` Valore: 0x1 Convalidare tutti i componenti del pacchetto in base ai requisiti di conformità OPC quando viene caricato un pacchetto. Per altre informazioni sulla convalida della conformità OPC , vedere Osservazioni. Se questa impostazione è abilitata, i costi delle prestazioni per il caricamento e la convalida dei componenti del pacchetto vengono pagati al primo caricamento del pacchetto.
`OPC_CACHE_ON_ACCESS` Valore: 0x2 Memorizzare nella cache i dati dei componenti del pacchetto decompressi come file temporaneo quando si accede al componente per la prima volta. Quando si accede ripetutamente a un componente del pacchetto, questa memorizzazione nella cache riduce il sovraccarico perché i dati del componente vengono decompressi una volta per la prima lettura anziché una volta per ogni operazione di lettura.

Commenti

Se vengono impostati sia il OPC_CACHE_ON_ACCESS che OPC_VALIDATE_ON_LOAD flag di lettura, tutti i componenti del pacchetto vengono decompressi e memorizzati nella cache quando viene caricato un pacchetto.

Le API di creazione pacchetti non usano la funzionalità delle proprietà di base OPC ; pertanto, i requisiti delle proprietà principali elencati nella tabella H-9 del OPC non vengono convalidati dalle API di creazione pacchetti. Per altre informazioni sui requisiti di conformità OPC , vedere 1° edizione, Parte 2: Open Packaging Conventions in ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Importante Le parti possono essere lette ripetutamente dal flusso in qualsiasi momento, indipendentemente dai flag di lettura impostati. Ad esempio, quando un pacchetto viene salvato, è possibile accedere di nuovo alle relazioni in una parte Relazioni del pacchetto originale per mantenere la compatibilità dei markup.