Joinc Wiki: winapi : ReadFile - 파일에서 데이터를 읽는다.

Facebook Joinc 그룹 Joinc QA 사이트

현재위치 : 메뉴얼>winapi>ReadFile

joinc는 Firefox와 chrome에서 테스트 했습니다. IE에서는 테이블이 깨지거나 이미지가 보이지 않을 수 있습니다. 특히 구글 Docs이미지의 경우 엑박처리될 수 있습니다.

ReadFile

특수 파일 혹은 입출력 장치로 부터 데이터를 읽는다.

이 함수는 동기, 비동기 모두에 사용할 수 있다. 비동기로만 사용할 수 아씨는 함수로 ReadFileEx함수가 있다.

사용법

BOOL WINAPI ReadFile( 
  __in         HANDLE hFile, 
  __out        LPVOID lpBuffer, 
  __in         DWORD nNumberOfBytesToRead, 
  __out_opt    LPDWORD lpNumberOfBytesRead, 
  __inout_opt  LPOVERLAPPED lpOverlapped 
);

매개 변수

hFile

파일, 파일 스트림, 물리디스크, 테이프 드라이브, 소켓과 같은 장치의 핸들.

hFile 매개 변수는 반드시 read 권한과 함께 만들어야 한다. 비동기 읽기를 원한다면 CreateFile함수, socket 혹은 accept함수로 파일을 생성할 때 FILE_FLAG_OVERLAPPED플래그를 사용해야 한다.
lpBuffer

파일이나 장치로 부터 받은 데이터를 저장하기 위한 버퍼를 가리키는 포인터
nNumberOfBytesToRead

읽을 최대 바이트 크기
lpNumberOfByteRead

동기 입출력 모드에서, 읽어들인 데이터의 바이트 수를 넘긴다.
lpOverlapped

비동기 입출력을 위한 OVERLAPPED 구조체의 포인터. hFile이 FILE_FLAG_OVERLAPPED 플로그로 열렸다면, 반드시 이 구조체를 사용해야 한다. 비동기 입출력이 아니라면 NULL을 사용한다.

반환 값

성공하면 0이 아닌 값을 리턴한다.

함수가 실패할때 혹은 비동기 입출력을 완료했을 때도 0을 반환한다. 자세한 에러 값은 GetLastError함수로 확인 할 수 아씨다.

GetLastError 코드가 ERROR_IO_PENDING이면, 실패가 아니다. 이것은 비동기 입출력이 완료되었음을 의미한다.

상세 설명

ReadFile함수는 아래의 이유로 반환한다.

데이터를 읽었다.
파이프에 쓰기가 완료되었다.
비동기 핸들러가 사용되고, 비동기 입력이 발생했을 때
에러의 발생

ReadFile함수가 파일의 끝에 도달하면 0을 반환하고 GetLastError함수는 ERROR_HANDLE_EOF를 반환한다.

예제

프로그램 실행인자로 주어진 파일명을 열어서 내용을 출력한다.

001  #include <stdio.h> 
002  #include <windows.h> 
003   
004  #define MAX_LINE 1024 
005  int main(int argc, char **argv) 
006  { 
007      HANDLE fp; 
008      DWORD readn; 
009      BOOL brtv; 
010      char buf[MAX_LINE]; 
011   
012      if (argc != 2) 
013      { 
014          printf("Usage : %s [file]\n", argv[0]); 
015          return 1; 
016      } 
017   
018      fp = CreateFile( 
019          (LPCTSTR)argv[1],  
020          GENERIC_READ, 
021          0, 
022          NULL, 
023          OPEN_EXISTING, 
024          FILE_ATTRIBUTE_NORMAL, 
025          NULL); 
026      if (fp == INVALID_HANDLE_VALUE) 
027      { 
028          printf("File 1 Open Error (%d) : %s\n", GetLastError(), argv[1]); 
029          return 1; 
030      } 
031   
032      while(1) 
033      { 
034          memset((void *)buf, 0x00, MAX_LINE);
035          brtv = ReadFile(fp,buf, MAX_LINE-1, &readn, NULL); 
036          if(brtv && readn == 0) 
037          { 
038              break; 
039          } 
040          printf("%s", buf); 
041      } 
042      return 1; 
043  } 
044

태그 : 윈도 시스템 프로그래밍 파일

뇌자극 QA 뇌자극 에러 및 수정목록 총 페이지 수 : 3224 전체 함수/용어사전 구글검색방법 구글 맞춤검색	Facebook Joinc 그룹 Joinc QA 사이트 현재위치 : 메뉴얼>winapi>ReadFile Tweet joinc는 Firefox와 chrome에서 테스트 했습니다. IE에서는 테이블이 깨지거나 이미지가 보이지 않을 수 있습니다. 특히 구글 Docs이미지의 경우 엑박처리될 수 있습니다. ReadFile 특수 파일 혹은 입출력 장치로 부터 데이터를 읽는다. 이 함수는 동기, 비동기 모두에 사용할 수 있다. 비동기로만 사용할 수 아씨는 함수로 ReadFileEx함수가 있다. 사용법 BOOL WINAPI ReadFile( __in HANDLE hFile, __out LPVOID lpBuffer, __in DWORD nNumberOfBytesToRead, __out_opt LPDWORD lpNumberOfBytesRead, __inout_opt LPOVERLAPPED lpOverlapped ); 매개 변수 hFile 파일, 파일 스트림, 물리디스크, 테이프 드라이브, 소켓과 같은 장치의 핸들. hFile 매개 변수는 반드시 read 권한과 함께 만들어야 한다. 비동기 읽기를 원한다면 CreateFile함수, socket 혹은 accept함수로 파일을 생성할 때 FILE_FLAG_OVERLAPPED플래그를 사용해야 한다. lpBuffer 파일이나 장치로 부터 받은 데이터를 저장하기 위한 버퍼를 가리키는 포인터 nNumberOfBytesToRead 읽을 최대 바이트 크기 lpNumberOfByteRead 동기 입출력 모드에서, 읽어들인 데이터의 바이트 수를 넘긴다. lpOverlapped 비동기 입출력을 위한 OVERLAPPED 구조체의 포인터. hFile이 FILE_FLAG_OVERLAPPED 플로그로 열렸다면, 반드시 이 구조체를 사용해야 한다. 비동기 입출력이 아니라면 NULL을 사용한다. 반환 값 성공하면 0이 아닌 값을 리턴한다. 함수가 실패할때 혹은 비동기 입출력을 완료했을 때도 0을 반환한다. 자세한 에러 값은 GetLastError함수로 확인 할 수 아씨다. GetLastError 코드가 ERROR_IO_PENDING이면, 실패가 아니다. 이것은 비동기 입출력이 완료되었음을 의미한다. 상세 설명 ReadFile함수는 아래의 이유로 반환한다. 데이터를 읽었다. 파이프에 쓰기가 완료되었다. 비동기 핸들러가 사용되고, 비동기 입력이 발생했을 때 에러의 발생 ReadFile함수가 파일의 끝에 도달하면 0을 반환하고 GetLastError함수는 ERROR_HANDLE_EOF를 반환한다. 예제 프로그램 실행인자로 주어진 파일명을 열어서 내용을 출력한다. 001 #include <stdio.h> 002 #include <windows.h> 003 004 #define MAX_LINE 1024 005 int main(int argc, char *argv) 006 { 007 HANDLE fp; 008 DWORD readn; 009 BOOL brtv; 010 char buf[MAX_LINE]; 011 012 if (argc != 2) 013 { 014 printf("Usage : %s [file]\n", argv[0]); 015 return 1; 016 } 017 018 fp = CreateFile( 019 (LPCTSTR)argv[1], 020 GENERIC_READ, 021 0, 022 NULL, 023 OPEN_EXISTING, 024 FILE_ATTRIBUTE_NORMAL, 025 NULL); 026 if (fp == INVALID_HANDLE_VALUE) 027 { 028 printf("File 1 Open Error (%d) : %s\n", GetLastError(), argv[1]); 029 return 1; 030 } 031 032 while(1) 033 { 034 memset((void )buf, 0x00, MAX_LINE); 035 brtv = ReadFile(fp,buf, MAX_LINE-1, &readn, NULL); 036 if(brtv && readn == 0) 037 { 038 break; 039 } 040 printf("%s", buf); 041 } 042 return 1; 043 } 044 태그 : 윈도 시스템 프로그래밍 파일