Expand Minimize

StgGetIFillLockBytesOnFile function

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

The StgGetIFillLockBytesOnFile function opens a wrapper object on a temporary file.

Syntax


WINOLEAPI StgGetIFillLockBytesOnFile(
  _In_   OLECHAR *pwcsName,
  _Out_  IFillLockBytes **ppflb
);

Parameters

pwcsName [in]

A pointer to the null-terminated unicode string name of the file for which a wrapper object is created.

ppflb [out]

A 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_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, and E_FAIL, in addition to the following:

S_OK

Indicates that the wrapper object was successfully created.

STG_E_FILENOTFOUND

Indicates that the file specified by pwcsName cannot be found.

STG_E_INSUFFICIENTMEMORY

There is not enough memory to perform this operation.

STG_E_INVALIDPOINTER

Indicates non-valid pointer in the ppflb parameter.

The StgGetIFillLockBytesOnFile function can also return any file system errors.

Remarks

The moniker that manages the downloading of the file specified in pwcsName calls this function in the course of creating the asynchronous storage necessary to manage the asynchronous downloading of data. The moniker first creates a temporary file, then calls this function to create the wrapper object on that file. Finally, the moniker calls StgOpenAsyncDocfileOnIFillLockBytes to open the root storage of the compound file to be downloaded into the temporary file.

Requirements

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

IFillLockBytes
ILockBytes
StgOpenAsyncDocfileOnIFillLockBytes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft