StgOpenAsyncDocfileOnIFillLockBytes

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

WINOLEAPI StgOpenAsyncDocFileOnIFillLockBytes(

IFillLockBytes *pflb	// Pointer to byte array wrapper object
DWORD grfmode	// Storage access mode
DWORD asyncFlags	// Asynchronous storage flags
IStorage **ppstgOpen	// Indirect pointer to asynchronous storage
);

Parameters

pflb

[in] IFillLockBytes194LHM2 pointer to the byte array wrapper object that contains the storage object to be opened.

grfmode

[in] Specifies the access mode to use to open the storage object. The most common access mode, taken from the STGMJWLKYA enumeration, is STGM_READ.

asyncFlags

[in] Indicates whether a connection point on a storage will be 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] Pointer to IStorageFS1VT1 pointer on root asynchronous storage object.

Return Values

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 pointers was not returned to the requested interface.

STG_E_INSUFFICIENTMEMORY

There is insufficient 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 IStorageFS1VT1 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 StgGetIFillLockBytesOnFile8KYX0MU function.

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

The returned storage object has a connection point for IProgressNotifyB51QT7.