FindFirstFile(A)

FindFirstFile(A)

지정한 파일명에 일치하는 파일이나 디렉토리를 검색합니다.

HANDLE FindFirstFileA(
    PCTSTR           pFileName, // 검색하는 파일명
    PWIN32_FIND_DATA pFindData  // 정보를 격납하는 구조체
);

KERNEL32.DLL

인수

pFileName

유효한 디렉토리명인가, 패스를 포함한 파일명을 나타내는 문자열의 주소를 지정합니다.이 파일명에는 와일드 카드(“*”(이)나“?”)를 포함할 수 있습니다.이 문자열의 사이즈는 260 (MAX_PATH) 이하가 아니면 안됩니다.

Windows NT/2000/XP： Unicode 판 함수( FindFirstFileW 함수)를 사용해, 패스명의 전에 "\\?\" 또는 "\\?\UNC" (을)를 붙이는 것으로, 260 (MAX_PATH) 문자보다 긴 문자열을 지정할 수 있습니다.

pFindData

최초의 파일에 관한 정보를 격납하기 위한 WIN32_FIND_DATA 구조체의 주소를 지정합니다.

반환값

성공하면, FindNextFile 또는 FindClose 함수로 사용되는 검색 핸들이 돌아갑니다.

실패하면, -1 (INVALID_HANDLE_VALUE) 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

FindFirstFile 함수는, 최초로 찾아낼 수 있었던 파일의 정보를 취득합니다.2번째 이후의 파일의 정보를 얻으려면 , 이 함수의 반환값으로서 얻을 수 있는 검색 핸들을 인수로서 FindNextFile 함수를 호출합니다.

검색 핸들이 불필요하게 되었을 경우는, FindClose 함수를 호출해 핸들을 클로우즈 하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후