AssociateFileEx 関数 (filehc.h)

ファイルを非同期コンテキストに関連付けます。

構文

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

[in] hFile

コンテキスト内に存在する必要があるファイルハンドル。非同期 I/O 操作用にFILE_FLAG_OVERLAPPED フラグが設定された状態で作成されます。

[in] fStoreWithDots

TRUE に設定すると、このオブジェクトはドット詰め込みで格納されました。

[in] fStoredWithTerminatingDot

終了ドットがオブジェクトに含まれるかどうかを示すフラグ。このパラメーターが TRUE に設定されている場合、オブジェクトは終了ドットで格納されます。

終了ドットは、NNTP/SMTP プロトコルによってメッセージの末尾を識別するために使用されます。

取得した FIO_CONTEXT 構造体へのポインターを返します。関数が失敗した場合は、NULL が返されます。