enumeração OPC_READ_FLAGS (msopc.h)

Artigo
02/29/2024

Descreve as configurações de leitura para armazenar em cache os componentes do pacote e validá-los em relação aos requisitos de conformidade do ECMA-376 OpenXML, 1ª Edição, Parte 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 um componente de pacote em relação aos requisitos de conformidade do OPC quando o componente for acessado. Para obter mais informações sobre a validação de conformidade OPC , consulte Comentários. Quando a validação é executada no acesso, os erros de validação de OPC podem ser retornados por qualquer método.
`OPC_VALIDATE_ON_LOAD` Valor: 0x1 Valide todos os componentes do pacote em relação aos requisitos de conformidade do OPC quando um pacote for carregado. Para obter mais informações sobre a validação de conformidade OPC , consulte Comentários. Se essa configuração estiver habilitada, os custos de desempenho para carregar e validar componentes do pacote serão pagos quando o pacote for carregado pela primeira vez.
`OPC_CACHE_ON_ACCESS` Valor: 0x2 Armazene em cache os dados do componente do pacote descompactado como um arquivo temporário ao acessar o componente pela primeira vez. Quando um componente de pacote é acessado repetidamente, esse cache reduz a sobrecarga porque os dados do componente são descompactados uma vez para a primeira leitura em vez de uma vez para cada operação de leitura.

Comentários

Se os sinalizadores de leitura OPC_CACHE_ON_ACCESS e OPC_VALIDATE_ON_LOAD estiverem definidos, todos os componentes do pacote serão descompactados e armazenados em cache quando um pacote for carregado.

As APIs de empacotamento não usam o recurso de propriedades principais do OPC ; Portanto, os principais requisitos de propriedades listados na Tabela H-9 do OPC não são validados pelas APIs de Empacotamento. Para obter mais informações sobre os requisitos de conformidade com OPC , consulte 1ª edição, Parte 2: Open Packaging Conventions in ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Importante As partes podem ser lidas repetidamente do fluxo a qualquer momento, independentemente de quais sinalizadores de leitura estão definidos. Por exemplo, quando um pacote é salvo, relações acessadas anteriormente em uma parte Relações no pacote original podem ser acessadas novamente para preservar a compatibilidade de marcação.