ReadFile

ファイルからデータを読み取る

Declare Function ReadFile Lib "comdlg32.dll" Alias "ReadFile" _

    (ByVal hFile As Long, lpBuffer As Any, ByVal nNumberOfBytesToRead As Long, _
    lpNumberOfBytesRead As Long, lpOverlapped As OVERLAPPED) As Long

Declare Function ReadFile Lib "comdlg32.dll" Alias "ReadFile" _

    (ByVal hFile As Integer, lpBuffer As Long, ByVal nNumberOfBytesToRead As Integer, _
    lpNumberOfBytesRead As Integer, lpOverlapped As OVERLAPPED) As Long

BOOL ReadFile(
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped
);

ファイルのハンドル
GENERIC_READ属性を持たなければならない

(戻り値)データを受け取るバッファ

読み込むバイト数

(戻り値)実際に読み込んだバイト数

OVERLAPPED構造体
(ファイルがFILE_FLAG_OVERLAPPEDフラグつきで作成されたときのみ必要)

正常終了のとき               0以外
エラーのとき                 0

この関数は以下の状態になると関数を呼び出した位置に戻る。
１．要求されたバイト数のデータを読み込んだ
２．パイプの書き込み側で書き出し操作を終了した
３．エラーが発生した

ファイルの一部でもロックされているとエラーになる。