enumerasi OPC_READ_FLAGS (msopc.h)

Artikel
10/26/2023

Menjelaskan pengaturan baca untuk komponen paket penembolokan dan memvalidasinya terhadap persyaratan kesamaan ECMA-376 OpenXML, Edisi Ke-1, Bagian 2: Konvensi Kemasan Terbuka (OPC ).

Sintaks

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;

Konstanta


`OPC_READ_DEFAULT` Nilai: 0 Validasi komponen paket terhadap persyaratan kesesuaian OPC saat komponen diakses. Untuk informasi selengkapnya tentang validasi kesamaan OPC , lihat Keterangan. Ketika validasi dilakukan pada akses, kesalahan validasi OPC dapat dikembalikan dengan metode apa pun.
`OPC_VALIDATE_ON_LOAD` Nilai: 0x1 Validasi semua komponen paket terhadap persyaratan kesamaan OPC saat paket dimuat. Untuk informasi selengkapnya tentang validasi kesamaan OPC , lihat Keterangan. Jika pengaturan ini diaktifkan, biaya performa untuk memuat dan memvalidasi komponen paket dibayar saat paket pertama kali dimuat.
`OPC_CACHE_ON_ACCESS` Nilai: 0x2 Cache data komponen paket yang didekompresi sebagai file sementara saat mengakses komponen untuk pertama kalinya. Ketika komponen paket diakses berulang kali, penembolokan ini mengurangi overhead karena data komponen didekompresi satu kali untuk baca pertama, bukan sekali untuk setiap operasi baca.

Keterangan

Jika bendera baca OPC_CACHE_ON_ACCESS dan OPC_VALIDATE_ON_LOAD diatur, semua komponen paket didekompresi dan di-cache saat paket dimuat.

API Pengemasan tidak menggunakan fitur properti inti OPC ; oleh karena itu, persyaratan properti inti yang tercantum dalam Tabel H-9 dari OPC tidak divalidasi oleh API Pengemasan. Untuk informasi selengkapnya tentang persyaratan kesamaan OPC , lihat edisi ke-1, Bagian 2: Konvensi Kemasan Terbuka di ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/).

Penting Bagian dapat berulang kali dibaca dari aliran kapan saja, terlepas dari bendera baca mana yang ditetapkan. Misalnya, ketika paket disimpan, hubungan yang sebelumnya diakses di bagian Hubungan dalam paket asli dapat diakses lagi untuk mempertahankan kompatibilitas markup.