FIOWriteFile

[This is preliminary documentation and subject to change.]

The FIOWriteFile function performs an asynchronous write to the handle contained within the referenced FIO_CONTEXT structure.

BOOL
FIOWriteFile(
    PFIO_CONTEXT  pContext,
    LPCVOID       lpBuffer,
    DWORD         BytesToWrite,
    FH_OVERLAPPED * lpo
);

Parameters

pContext

A reference to the FIO_CONTEXT containing the file handle for which to perform the write operation.

lpBuffer

A buffer containing the content to write.

BytesToWrite

The number of bytes stored in the buffer.

lpo

A reference to an FH_OVERLAPPED structure used to indicate the starting offset for the write. This structure is semantically identical to the standard OVERLAPPED structure.

Return Values

This function returns TRUE if the operation succeeded and the file I/O operation is running asynchronously.

Remarks

This function is designed to work with the other portions of the FCACHDLL library provided with the Microsoft SMTP Service for Windows 2000. The results are identical to those achieved using the standard Win32 WriteFile and WriteFileEx functions.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in filehc.h; include filehc.h.
  Library: Use fcachdll.lib.

See Also

FIOReadFile, AssociateFile, FIO_CONTEXT, FH_OVERLAPPED