AssociateFileEx function

Associates a file with an asnychronous context.

Syntax

FILEHC_EXPORT PFIO_CONTEXT AssociateFileEx(
  HANDLE hFile,
  BOOL   fStoreWithDots,
  BOOL   fStoredWithTerminatingDot
);

Parameters

hFile

A file handle that should be in the context. It is created with the FILE_FLAG_OVERLAPPED flag set for asynchronous I/O operations.

fStoreWithDots

TBD

fStoredWithTerminatingDot

A flag that indicates whether the terminating dot is included in an object. If this parameter is set to TRUE, the object is stored with a terminating dot.

The terminating dot is used by the NNTP/SMTP protocol to identify the end of message.

Return Value

Returns a pointer to the FIO_CONTEXT structure that was obtained. If the function fails, it returns NULL.

Requirements

   
Target Platform Windows
Header filehc.h
Library Fcachdll.lib
DLL Fcachdll.dll

See Also

FIO_CONTEXT