OPC_READ_FLAGS列舉 (msopc.h)

發行項
03/13/2024

描述快取套件元件的讀取設定，並針對 ECMA-376 OpenXML、第1版、第2部分：OPEN Packaging慣例 (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;

常數


`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 核心屬性功能;因此，封裝 API 不會驗證 OPC 表格 H-9 中列出的核心屬性需求。如需 OPC 一致性需求的詳細資訊，請參閱第 1 版第 2 部分： ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/) 中的開放式封裝慣例。

重要不論設定了哪些讀取旗標，元件隨時都可以重複讀取數據流。例如，儲存封裝時，可以再次存取原始封裝中關聯性部分中的先前存取關聯性，以保留標記相容性。