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 |