OPC_READ_FLAGS 列挙 (msopc.h)

[アーティクル]
03/05/2024

パッケージコンポーネントをキャッシュし、 ECMA-376 OpenXML、1st Edition、パート 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 初めてコンポーネントにアクセスするときに、圧縮解除されたパッケージコンポーネントデータを一時ファイルとしてキャッシュします。パッケージコンポーネントに繰り返しアクセスする場合、コンポーネントデータは読み取り操作ごとに 1 回ではなく、最初の読み取りで 1 回圧縮解除されるため、このキャッシュによってオーバーヘッドが軽減されます。

注釈

OPC_CACHE_ON_ACCESSとOPC_VALIDATE_ON_LOADの両方の読み取りフラグが設定されている場合、パッケージの読み込み時にすべてのパッケージコンポーネントが展開され、キャッシュされます。

パッケージ化 API では 、OPC コアプロパティ機能は使用されません。したがって、 OPC の表 H-9 に記載されているコアプロパティの要件は、パッケージ化 API では検証されません。 OPC 準拠の要件の詳細については、「1st edition, Part 2: Open Packaging Conventions in ECMA-376 OpenXML (https://www.ecma-international.org/publications-and-standards/standards/ecma-376/)」を参照してください。

大事な どの読み取りフラグが設定されているかに関係なく、パーツはいつでもストリームから繰り返し読み取られます。たとえば、パッケージを保存すると、マークアップの互換性を維持するために、元のパッケージのリレーションシップパーツ内の以前にアクセスされたリレーションシップに再度アクセスできます。