AssociateFileEx function (filehc.h)

Associates a file with an asnychronous context.

Syntax

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

Parameters

[in] 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.

[in] fStoreWithDots

If set to TRUE, this object was stored with dot stuffing.

[in] 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

See also

FIO_CONTEXT