OPC_READ_FLAGS 枚举 (msopc.h)

项目
03/05/2024

介绍用于缓存包组件并针对 ECMA-376 OpenXML，第 1 版第 2 部分：开放打包约定 (OPC) 一致性要求对其进行验证的读取设置。

语法

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;

常量


`OPC_READ_DEFAULT` 值： 0 访问组件时，根据 OPC 符合性要求验证包组件。有关 OPC 符合性验证的详细信息，请参阅备注。在访问时执行验证时，任何方法都可以返回 OPC 验证错误。
`OPC_VALIDATE_ON_LOAD` 值： 0x1 加载包时，根据 OPC 符合性要求验证所有包组件。有关 OPC 符合性验证的详细信息，请参阅备注。如果启用此设置，则会在首次加载包时支付加载和验证包组件的性能成本。
`OPC_CACHE_ON_ACCESS` 值： 0x2 首次访问组件时，将解压缩的包组件数据缓存为临时文件。当重复访问包组件时，此缓存可以减少开销，因为组件数据在首次读取时解压缩一次，而不是每次读取操作解压缩一次。

注解

如果同时设置了 OPC_CACHE_ON_ACCESS 和 OPC_VALIDATE_ON_LOAD 读取标志，则会在加载包时解压缩并缓存所有包组件。

打包 API 不使用 OPC 核心属性功能;因此， OPC 表 H-9 中列出的核心属性要求不会通过打包 API 进行验证。有关 OPC 符合性要求的详细信息，请参阅第 1 版第 2 部分： ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/) 中的开放打包约定。

重要无论设置了哪些读取标志，都可以随时从流中重复读取部分。例如，保存包时，可以再次访问原始包中关系部件中以前访问的关系，以保持标记兼容性。