Expand Minimize

StgGetIFillLockBytesOnILockBytes function

[The StgGetIFillLockBytesOnILockBytes function is obsolete and the following information is provided for versions of Windows prior to Windows 2000.]

Creates a new wrapper object on a byte array object provided by the caller.

Syntax


WINOLEAPI StgGetIFillLockBytesOnILockBytes(
  _In_   ILockBytes *pilb,
  _Out_  IFillLockBytes **ppflb
);

Parameters

pilb [in]

Pointer to an existing byte array object.

ppflb [out]

Pointer to IFillLockBytes pointer variable that receives the interface pointer to the new byte array wrapper object.

Return value

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

S_OK

Indicates that the wrapper object was successfully created.

STG_E_INSUFFICIENTMEMORY

There is not enough memory to perform this operation.

STG_E_INVALIDPOINTER

Indicates non-valid pointer in the pilb parameter.

Remarks

The StgGetIFillLockBytesOnILockBytes function makes it possible to create an asynchronous storage wrapper object on a custom byte-array object. For example, if you wanted to implement asynchronous storage on a database for which you have already created a byte-array object, you would call this function to create the wrapper object for the byte array. To do so, the function creates a new wrapper object and then initializes it by passing it a pointer to the existing byte-array object.

Requirements

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

IFillLockBytes
ILockBytes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft