본문 바로가기

API / MFC/Function Information

[windows] FindFirstFile Function

지정된 이름과 같은 이름을 가진 파일이 있는 폴더나 서브 폴더를 검색(또는 임의 문자 기호를 사용할 경우 부분 이름)
검색에서 사용할 추가 속성을 지정하려면 FindFirstFileEx 함수를 사용
이 작업이 트랜스된 작업으로 수행할 때 FindFirstFileTransacted 함수 사용

HANDLE WINAPI FindFirstFile(
  __in   LPCTSTR lpFileName,
  __out  LPWIN32_FIND_DATA lpFindFileData
);


lpFileName [in]
    폴더나 경로그리고 파일 이름에 와일드카드 문자를 포함 할수 있음(*, ?)
    이 매개변수는 NULL, 잘못된 문자열(빈 문자열 또는 종료 Null 문자가 누락된 문자열) 또는 마지막에 \를 사용하면 안됨
    만약 와일드카드, 마침표(.), 또는 폴더 이름으로 문자열을 끝낼 경우 사용자는 루트에서 액세스 허가와 모든 서브 폴더의 
     경로를 가져야 함
    이 함수는 ANSI 버젼으로 이름을 MAX_PATH 문자 까지 입력 가능 
    32, 767개의 widecharacters 확장하기 위해 함수는 유니코드 버전의 호출하여 경로 앞에 "\\? \" 사용 하여 사용

lpFindFileData [out]
    찾은 파일 또는 폴더에 대한 정보를 받는 WIN32_FIND_DATA 구조체의 포인터


참고 :
http://msdn.microsoft.com/en-us/library/aa364418(VS.85).aspx