Fungsi StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Artikel
08/25/2023

[Fungsi StgOpenAsyncDocfileOnIFillLockBytes sudah usang. Informasi berikut disediakan untuk mendukung versi Windows sebelum Windows 2000.]

StgOpenAsyncDocfileOnIFillLockBytes membuka objek penyimpanan asinkron root yang ada pada objek pembungkus byte-array yang disediakan oleh pemanggil.

Sintaks

HRESULT StgOpenAsyncDocfileOnIFillLockBytes(
  [in]  IFillLockBytes *pflb,
  [in]  DWORD          grfMode,
  [in]  DWORD          asyncFlags,
  [out] IStorage       **ppstgOpen
);

Parameter

[in] pflb

Penunjuk IFillLockBytes ke objek pembungkus byte-array yang berisi objek penyimpanan yang akan dibuka.

[in] grfMode

Nilai yang menentukan mode akses yang akan digunakan untuk membuka objek penyimpanan. Mode akses paling umum, yang diambil dari Konstanta STGM, adalah STGM_READ.

[in] asyncFlags

Nilai yang menunjukkan apakah titik koneksi pada penyimpanan diwariskan oleh substorase dan alirannya. ASYNC_MODE_COMPATIBILITY menunjukkan bahwa titik koneksi diwariskan; ASYNC_MODE_DEFAULT menunjukkan bahwa titik koneksi tidak diwariskan.

[out] ppstgOpen

Penunjuk ke variabel pointer IStorage* yang menerima penunjuk antarmuka ke objek penyimpanan asinkron akar.

Nilai kembali

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

Keterangan

Penyimpanan akar objek penyimpanan asinkron dibuka sesuai dengan mode akses dalam parameter grfMode . Penunjuk ke antarmuka IStorage pada objek penyimpanan yang dibuka disediakan melalui parameter ppstgOpen .

Objek pembungkus array byte harus telah dibuat sebelumnya melalui panggilan ke fungsi StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes tidak mendukung mode akses prioritas atau pengecualian. Jika tidak, ia bekerja dengan cara yang sama seperti fungsi StgOpenStorageOnILockBytes .

Objek penyimpanan yang dikembalikan memiliki titik koneksi untuk IProgressNotify.