Share via


FIOWriteFile

FIOWriteFile

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

Syntax

        BOOL 
FIOWriteFile( 
    PFIO_CONTEXTpContext,
    LPCVOIDlpBuffer,
    DWORDBytesToWrite,
    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

Concepts

FIOReadFile
AssociateFile
FIO_CONTEXT
FH_OVERLAPPED