Export (0) Print
Expand All

StgOpenAsyncDocfileOnIFillLockBytes function

[The StgOpenAsyncDocfileOnIFillLockBytes function is obsolete. The following information is provided to support versions of Windows prior to Windows 2000.]

The StgOpenAsyncDocfileOnIFillLockBytesopens an existing root asynchronous storage object on a byte-array wrapper object provided by the caller.

Syntax


WINOLEAPI StgOpenAsyncDocfileOnIFillLockBytes(
  _In_   IFillLockBytes *ppflb,
  _In_   DWORD grfmode,
  _In_   DWORD asyncFlags,
  _Out_  IStorage **ppstgOpen
);

Parameters

ppflb [in]

A IFillLockBytes pointer to the byte-array wrapper object that contains the storage object to be opened.

grfmode [in]

A value that specifies the access mode to use to open the storage object. The most common access mode, taken from STGM Constants, is STGM_READ.

asyncFlags [in]

A value that indicates whether a connection point on a storage is inherited by its substorages and streams. ASYNC_MODE_COMPATIBILITY indicates that the connection point is inherited; ASYNC_MODE_DEFAULT indicates that the connection point is not inherited.

ppstgOpen [out]

A pointer to IStorage* pointer variable that receives the interface pointer to the root asynchronous storage object.

Return value

This function supports the standard return values E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, and E_FAIL, as well as the following:

E_PENDING

Data is currently unavailable.

E_NOINTERFACE

A pointer was not returned to the requested interface.

STG_E_INSUFFICIENTMEMORY

There is not enough memory to complete this operation.

Remarks

The root storage of the asynchronous storage object is opened according to the access mode in the grfMode parameter. A pointer to the IStorage interface on the opened storage object is supplied through the ppstgOpen parameter.

The byte array wrapper object must have been previously instantiated through a call to the StgGetIFillLockBytesOnFile function.

StgOpenAsyncDocfileOnIFillLockBytes does not support priority access mode or exclusions. Otherwise, it works in much the same way as the StgOpenStorageOnILockBytes function.

The returned storage object has a connection point for IProgressNotify.

Requirements

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

IFillLockBytes
ILockBytes
StgGetIFillLockBytesOnFile
StgOpenStorageOnILockBytes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft