StgOpenLayoutDocfile 関数 (objbase.h)

[アーティクル]
08/25/2023

サポートされていません。

StgOpenLayoutDocfile 関数は、セクターデータを監視できる ILockBytes 実装で複合ファイルを開きます。 StgOpenLayoutDocfile を呼び出すには、DfLayout.dll と DfLayout.lib の両方が必要です。

メモこの関数は使用しないでください。代わりに IStorage::CopyTo メソッドを使用してください。 CopyTo を使用してドキュメントファイルをレイアウトできるため、ほとんどのシナリオでパフォーマンスが向上します。

構文

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

パラメーター

[in] pwcsDfName

開く複合ファイルの null で終わる Unicode 文字列名へのポインター。

[in] grfMode

新しく作成されたストレージオブジェクトを開くときに使用するアクセスモード。値は STGM 定数から取得されます。優先度モードと除外はサポートされていないことに注意してください。最も一般的なアクセスモードはSTGM_DIRECTされる可能性が高い |STGM_READ |STGM_SHARE_EXCLUSIVE。

[in] reserved

将来利用するために予約されています。

[out] ppstgOpen

新しく作成されたルートストレージオブジェクトのルートオブジェクトへのインターフェイスポインターを受け取る IStorage ポインター変数へのポインター。

戻り値

この関数は、次に加えて、標準の戻り値E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、およびE_FAILをサポートします。

StgOpenLayoutDocfile 関数は、StgOpenStorageOnILockBytes 関数によって返されるエラー値を返すこともできます。

注釈

この関数によって作成された複合ファイルの実装では、ルートストレージに ILayoutStorage インターフェイスが公開されます。アプリケーションでは、このインターフェイスを使用して複合ファイルの最適なレイアウトを表現し、低速リンクを介してデータをより迅速にダウンロードしてレンダリングします。 StgOpenLayoutDocfile は、新しく作成された複合ファイルのルートストレージ上の IStorage インターフェイスへのポインターを返します。このポインターを使用して、アプリケーションは QueryInterface を 呼び出して ILayoutStorage へのポインターを取得します。