#. 내용.
- 파일로 부터 데이터를 읽어옵니다. 주로 동기적인 입력에 사용하기 때문에 데이터를 완전히 읽기 전에는 리턴하지 않으며, 비동기 입력에 사용할 경우는 즉시 리턴합니다. 현재 파일 포인터 위치에서부터 데이터를 읽으며 다 읽은 후 실제 읽은 바이트 수만큼 파일 포인터를 이동시켜 줍니다. 단, 비동기 입출력중일 때는 응용 프로그램이 파일 포인터를 직접 이동시켜 주어야 합니다.
#. 원형.
BOOL ReadFile(
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped
);
#. 파라미터.
- HANDLE hFile: 읽고자 하는 파일의 핸들. 이 파일은 GENERIC_READ 액세스 권한으로 열어야 합니다.
- LPVOID lpBuffer: 읽어 올 데이터를 저장할 버퍼의 포인터 입니다.
- DWORD nNumberOfBytesToRead: 실제 읽어오는 바이트 수를 지정합니다.
- LPDWORD lpNumberOfBytesRead: 실제로 읽어온 바이트 수를 리턴하기 위한 출력용 인수입니다. ReadFile함수는 호출되는 즉시 이 값을 0으로 만듭니다. 비동기 입출력을 하지 않을 경우 이 인수는 null을 줄 수 없으며, 반드시 DWORD형 변수에 대한 포인터를 제공해야 합니다.
LPOVERLAPPED lpOverlapped: 비동기 입출력을 위한 OVERLAPPED 구조체의 포인터입니다. 파일을 FILE_FLAG_OVERLAPPED 플래그로 열었으면 이 구조체를 반드시 제공해야 하며 비동기 입출력을 사용하지 않을 경우 NULL을 주면 됩니다.
#. 리턴 값.
- 성공하면 0이 아닌 값을 리턴합니다.
- 리턴값이 0이 아닌데 실제 읽은 바이트가 0이라면 파일 포인터가 끝부분(EOF)인 것입니다.
- 실패하면 0을 리턴 합니다.
