_findfirst, _wfindfirst

아티클
06/09/2015

filespec 인수에서 지정된 파일과 일치하는 파일이름의 첫 번째 인스턴스에 관한 정보를 제공합니다.

intptr_t _findfirst(
   const char *filespec,
   struct _finddata_t *fileinfo 
);
intptr_t _findfirst32(
   const char *filespec,
   struct _finddata32_t *fileinfo 
);
intptr_t _findfirst64(
   const char *filespec,
   struct _finddata64_t *fileinfo 
);
intptr_t _findfirsti64(
   const char *filespec,
   struct _finddatai64_t *fileinfo 
);
intptr_t _findfirst32i64(
   const char *filespec,
   struct _finddata32i64_t *fileinfo 
);
intptr_t _findfirst64i32(
   const char *filespec,
   struct _finddata64i32_t *fileinfo 
);
intptr_t _wfindfirst(
   const wchar_t *filespec,
   struct _wfinddata_t *fileinfo 
);
intptr_t _wfindfirst32(
   const wchar_t *filespec,
   struct _wfinddata32_t *fileinfo 
);
intptr_t _wfindfirst64(
   const wchar_t *filespec,
   struct _wfinddata64_t *fileinfo 
);
intptr_t _wfindfirsti64(
   const wchar_t *filespec,
   struct _wfinddatai64_t *fileinfo 
);
intptr_t _wfindfirst32i64(
   const wchar_t *filespec,
   struct _wfinddata32i64_t *fileinfo 
);
intptr_t _wfindfirst64i32(
   const wchar_t *filespec,
   struct _wfinddata64i32_t *fileinfo 
);

매개 변수

filespec
대상 파일 사양 (와일드 카드 문자를 포함할 수 있습니다).
fileinfo
파일 정보 버퍼.

반환 값

만일 성공하면, _findfirst 는 filespec 사양에 일치하는 파일 또는 파일들의 그룹을 식별하는 고유한 검색 핸들을 반환하는데, 이것은 _findclose 또는 _findnext 에 대한 후속 호출에 사용될 수 있습니다. 그렇지 않으면, _findfirst 는 -1을 반환하고 다음 값들 중 하나를 errno 로 설정합니다.

EINVAL
잘못된 매개변수: filespec 또는 fileinfo 이 NULL입니다. 또는, 운영 체제는 예측하지 못한 오류를 반환합니다.
ENOENT
파일 사양에 일치하지 않습니다.
ENOMEM
메모리가 부족합니다.
EINVAL
잘못된 파일 이름 또는 파일 이름이 MAX_PATH 보다 큽니다.

이러한 반환 코드 및 기타 반환 코드에 대한 자세한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr을 참조하십시오.

만일 잘못된 매개변수가 전달된 경우, 매개 변수 유효성 검사 에 나타난 것처럼 이 함수는 잘못된 매개변수 처리기를 호출합니다.

설명

_findfirst 또는 _findnext 함수(또는 모든 변형들) 중 하나가 끝난 후에 _findclose 를 호출 해야합니다. 이 것은 응용 프로그램에서 이러한 함수에 의해 사용 되는 리소스를 해제합니다.

이러한 함수들의 변형은 와이드 문자 버전들인 w 접두사를 갖습니다; 그렇지 않으면, 대응되는 싱글바이트 함수들로 식별됩니다.

이러한 함수의 변형 시간은 32 비트 또는 64 비트 형식과 32 비트 또는 64 비트 길이를 지원합니다. 첫 번째 숫자 접미사 (32 또는 64) 는 시간 형식의 크기를 나타내고 둘째 접미사는 파일 길이가 32비트 또는 64 비트 정수로 표시되는 지를 알려주는 i32 또는 i64 입니다. 32 비트 및 64 비트 형식 및 파일 크기를 지원하는 버전들에 대한 자세한 정보는, 다음 표를 참조하세요. 만일 시간 형식의 크기가 같다면, i32 또는 i64 접미사가 생략하여 _findfirst64 는 64비트 파일 길이 역시 지원하고, _findfirst32 는 오직 32비트 파일 길이만을 지원합니다.

이러한 함수를 는 fileinfo 매개변수에 대한 _finddata_t 구조체의 다양한 형식들을 사용합니다. 이 구조체에 대한 자세한 내용은 _find, _wfind 함수 를 참조하세요.

64 비트 시간 형식을 사용하는 이 변형은 3000년, 12월 31일 23시 59분 59초 UTC, 까지의 파일 작성 날짜를 표현할 수 있습니다. 32 비트 시간 형식을 사용하는 경우, 2038년 1월 18일 19시 14분 07초 UTC, 까지의 날짜를 나타냅니다. 1970년 1월 1일 자정은 모든 함수의 날짜 범위의 하한 값입니다.

명시적으로 시간의 크기를 지정하는 버전을 사용할 특별한 이유가 없다면, _findfirst 또는 _wfindfirst 을 사용하거나, 만일 3GB보다 큰 파일 크기를 지원해야 할 경우 _findfirsti64 또는 _wfindfirsti64 를 사용합니다. 이러한 모든 함수는 64 비트 시간 형식을 사용합니다. 이전 버전에서는, 이러한 함수는 32비트 시간 형식을 사용했습니다. 만일 이것이 응용 프로그램에 대해 다른 부분에 문제를 일으키는 경우, 이전 동작으로 되돌리기 위해 _USE_32BIT_TIME_T 를 정의할 수 있습니다. 만일 _USE_32BIT_TIME_T 이 정의된 경우, _findfirst , _finfirsti64 , 그리고 해당 유니코드 버전은 32비트 시간을 사용합니다.

_findfirst의 시간 형식 및 파일 길이 형식 변형

함수	_USE_32BIT_TIME_T가 정의되었습니까?	시간 형식	파일 길이 형식입니다.
_findfirst, _wfindfirst	정의 되지 않음	64비트	32비트
_findfirst, _wfindfirst	정의됨	32비트	32비트
_findfirst32, _wfindfirst32	매크로 정의에 영향을 받지 않음	32비트	32비트
_findfirst64, _wfindfirst64	매크로 정의에 영향을 받지 않음	64비트	64비트
_findfirsti64, _wfindfirsti64	정의 되지 않음	64비트	64비트
_findfirsti64, _wfindfirsti64	정의됨	32비트	64비트
_findfirst32i64, _wfindfirst32i64	매크로 정의에 영향을 받지 않음	32비트	64비트
_findfirst64i32, _wfindfirst64i32	매크로 정의에 영향을 받지 않음	64비트	32비트

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tfindfirst	_findfirst	_findfirst	_wfindfirst
_tfindfirst32	_findfirst32	_findfirst32	_wfindfirst32
_tfindfirst64	_findfirst64	_findfirst64	_wfindfirst64
_tfindfirsti64	_findfirsti64	_findfirsti64	_wfindfirsti64
_tfindfirst32i64	_findfirst32i64	_findfirst32i64	_wfindfirst32i64
_tfindfirst64i32	_findfirst64i32	_findfirst64i32	_wfindfirst64i32

요구 사항

Function	필수 헤더
_findfirst	<io.h>
_findfirst32	<io.h>
_findfirst64	<io.h>
_findfirsti64	<io.h>
_findfirst32i64	<io.h>
_findfirst64i32	<io.h>
_wfindfirst	<io.h> or <wchar.h>
_wfindfirst32	<io.h> or <wchar.h>
_wfindfirst64	<io.h> or <wchar.h>
_wfindfirsti64	<io.h> or <wchar.h>
_wfindfirst32i64	<io.h> or <wchar.h>
_wfindfirst64i32	<io.h> or <wchar.h>