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