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
Library	Ole32.lib
DLL	Ole32.dll

另请参阅

IFillLockBytes

ILockBytes

StgGetIFillLockBytesOnFile

StgOpenStorageOnILockBytes