관리 메뉴

ㄴrㅎnㅂrㄹrㄱi

FindFirstFile(A) 본문

API 관련/Win32 API 함수

FindFirstFile(A)

님투 2007. 11. 8. 22:50
반응형

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 이후

반응형

'API 관련 > Win32 API 함수' 카테고리의 다른 글

FormatMessage(A)  (0) 2007.11.08
FindNextFile(A)  (0) 2007.11.08
FindClose  (0) 2007.11.08
ExtractIconEx(A)  (0) 2007.11.08
ExtractIcon(A)  (0) 2007.11.08
Comments