Fungsi StgOpenLayoutDocfile (objbase.h)

Artikel
02/29/2024

Tidak didukung.

Fungsi StgOpenLayoutDocfile membuka file gabungan pada implementasi ILockBytes yang mampu memantau data sektor. Untuk memanggil StgOpenLayoutDocfile, diperlukan DfLayout.dll dan DfLayout.lib.

Catatan Jangan gunakan fungsi ini. Gunakan metode IStorage::CopyTo sebagai gantinya. CopyTo dapat digunakan untuk mengatur tata letak docfile, sehingga meningkatkan performa dalam sebagian besar skenario.

Sintaks

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

Parameter

[in] pwcsDfName

Penunjuk ke nama untai (karakter) Unicode yang dihentikan null dari file gabungan yang akan dibuka.

[in] grfMode

Mode akses untuk digunakan saat membuka objek penyimpanan yang baru dibuat. Nilai diambil dari Konstanta STGM. Ketahuilah bahwa mode prioritas dan pengecualian tidak didukung. Mode akses yang paling umum kemungkinan STGM_DIRECT | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

Disiapkan untuk penggunaan masa mendatang.

[out] ppstgOpen

Penunjuk ke variabel penunjuk IStorage yang menerima penunjuk antarmuka ke objek akar objek penyimpanan akar yang baru dibuat.

Nilai kembali

Fungsi ini mendukung nilai pengembalian standar E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, dan E_FAIL, selain yang berikut:

Fungsi StgOpenLayoutDocfile juga dapat mengembalikan salah satu nilai kesalahan yang dikembalikan oleh fungsi StgOpenStorageOnILockBytes .

Keterangan

Implementasi file gabungan yang dibuat oleh fungsi ini mengekspos antarmuka ILayoutStorage pada penyimpanan akarnya. Aplikasi menggunakan antarmuka ini untuk mengekspresikan tata letak optimal file senyawa mereka untuk mengunduh dan merender data dengan lebih cepat melalui tautan lambat. StgOpenLayoutDocfile mengembalikan pointer ke antarmuka IStorage pada penyimpanan akar file campuran yang baru dibuat. Dengan menggunakan pointer ini, aplikasi memanggil QueryInterface untuk mendapatkan pointer ke ILayoutStorage.