FindNextFile(A)

FindNextFile(A)

FindFirstFile 함수의 호출에 의한 검색을 속행합니다.

BOOL FindNextFileA(
    HANDLE           hFindFile, // 검색 핸들
    PWIN32_FIND_DATA pFindData  // 정보를 격납하는 구조체
);

KERNEL32.DLL

인수

hFindFile

FindFirstFile 함수에 의해서 돌려주어진 검색 핸들을 지정합니다.

lpFindData

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

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.적합하는 파일이 발견되지 않았던 경우, GetLastError 함수는 반환값으로서 18 (ERROR_NO_MORE_FILES) (을)를 돌려줍니다.

해설

지정한 이름과 적합하는 모든 파일이나 디렉토리를 검색하려면 , 우선 FindFirstFile 함수로1번째의 파일의 정보를 취득해, 반환값으로서 얻을 수 있던 검색 핸들을 인수로서 FindNextFile 함수를 호출합니다.FindNextFile 함수는, 직후에 호출했다 GetLastError 함수가 18 (ERROR_NO_MORE_FILES) (을)를 돌려줄 때까지 반복해 호출합니다.

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

대응 정보

Windows 95 이후 / Windows NT 3.1 이후