перечисление OPC_READ_FLAGS (msopc.h)

Статья
10/26/2023

Описание параметров чтения для кэширования компонентов пакета и их проверки на соответствие требованиям ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (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 Кэшируйте распакованные данные компонента пакета в виде временного файла при первом доступе к компоненту. При многократном доступе к компоненту пакета это кэширование снижает затраты, так как данные компонента распаковыются один раз для первого чтения, а не один раз для каждой операции чтения.

API упаковки не используют функцию основных свойств OPC ; Поэтому требования к основным свойствам, перечисленные в таблице H-9 OPC , не проверяются API упаковки. Дополнительные сведения о требованиях соответствия OPC см. в первой версии, часть 2. Открытые соглашения об упаковке в ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Важно Части могут многократно считываться из потока в любое время, независимо от того, какие флаги чтения установлены. Например, при сохранении пакета ранее доступные связи в части "Связи" в исходном пакете могут быть снова доступны для сохранения совместимости с разметкой.