StgOpenAsyncDocfileOnIFillLockBytes 函式 (objbase.h)

[ StgOpenAsyncDocfileOnIFillLockBytes 函式已過時。 提供下列資訊以支援 Windows 2000 之前的 Windows 版本。]

StgOpenAsyncDocfileOnIFillLockBytes 會在呼叫端提供的位元組陣列包裝函式對象上開啟現有的根異步儲存物件。

語法

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

參數

[in] pflb

包含要開啟之儲存物件的位元組數位包裝函式物件的 IFillLockBytes 指標。

[in] grfMode

值,指定要用來開啟記憶體物件的存取模式。 從 STGM 常數取得的最常見存取模式是STGM_READ。

[in] asyncFlags

值,指出記憶體上的連接點是否由其子記憶體和數據流繼承。 ASYNC_MODE_COMPATIBILITY表示已繼承連接點;ASYNC_MODE_DEFAULT表示未繼承連接點。

[out] ppstgOpen

IStorage* 指標變數的指標,可接收根異步記憶體物件的介面指標。

傳回值

此函式支援標準傳回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL,以及下列各項:

備註

異步記憶體物件的根記憶體會根據 grfMode 參數中的存取模式開啟。 開啟儲存物件上 IStorage 介面的指標是透過 ppstgOpen 參數提供。

位元組數位包裝函式物件之前必須透過 呼叫 StgGetIFillLockBytesOnFile 函式來具現化。

StgOpenAsyncDocfileOnIFillLockBytes 不支援優先順序存取模式或排除專案。 否則,它的運作方式與 StgOpenStorageOnILockBytes 函式的運作方式大致相同。

傳回的記憶體物件具有 IProgressNotify的連接點。

規格需求

需求 值
目標平台 Windows
標頭 objbase.h
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

IFillLockBytes

ILockBytes

StgGetIFillLockBytesOnFile

StgOpenStorageOnILockBytes