_findfirst, _wfindfirst

아티클
02/21/2013

에 지정 된 파일과 일치 하는 파일 이름의 첫 번째 인스턴스에 대 한 정보 제공의 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 후속 호출 하는 데 사용할 수 있는 사양 _findnext 또는 _findclose.그렇지 않으면 _findfirst – 1을 반환 하 고 설정 하는 errno 는 다음 값 중 하나입니다.

EINVAL
Invalid parameter: filespec or fileinfo was NULL.또는 운영 체제에서 예기치 않은 오류를 반환 합니다.
ENOENT
일치 하지 않는 파일 사양입니다.
ENOMEM
메모리가 부족 합니다.
EINVAL
지정 된 파일 이름 또는 잘못 된 파일 이름이 지정 된 보다 큰 MAX_PATH.

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

에 잘못 된 매개 변수가 전달 된 경우 이러한 함수는 잘못 된 매개 변수 처리기의 설명에 따라 호출 매개 변수 유효성 검사.

설명

호출 해야 _findclose 과 함께 작업을 완료 한 후에 _findfirst 또는 _findnext 함수 (또는 어떤 변형).응용 프로그램에서 이러한 함수에 의해 사용 되는 리소스를 해제 합니다.

변형 된 함수는 w 접두사는 와이드 문자 버전입니다. 그렇지 않으면 해당 단일 바이트 함수를 항등입니다.

32 비트 또는 64 비트 시간 형식 및 32 비트 또는 64 비트 파일 크기 변형 이러한 함수를 지원합니다.첫 번째 숫자 접미사 (32 또는 64)에서 시간 형식을 나타냅니다 두 번째 접미사입니다 i32 또는 i64, 파일 크기는 32 비트 또는 64 비트 정수를 나타내는 여부를 나타냅니다.32 비트 및 64 비트 시간 형식과 파일 크기 버전에 대 한 지원 정보에 대 한 다음 표를 참조 하십시오.i32 또는 i64 시간 입력 크기와 동일 하므로 인 경우 접미사가 생략 _findfirst64 또한 64 비트 파일 길이 지원 하 고 _findfirst32 32 비트 파일 길이 지원 합니다.

다양 한 형태의 이러한 함수를 사용의 _finddata_t 에 대 한 구조는 fileinfo 매개 변수.구조에 대 한 자세한 내용은 참조 하십시오. _find, _wfind 함수.

64 비트 시간 형식을 사용 하 여 각 버전 파일 작성 날짜를에 23시 59분: 59부터, 3000, 12 월 31 UTC를 표현할 수 있습니다.32 비트 시간 형식을 사용 하는 날짜를 19시 14분: 07 2038 년 1 월 18 일, UTC 통해서만 나타냅니다.자정 utc 1970 년 1 월 1 일의 모든이 함수에 대 한 날짜 범위입니다.

시간 크기를 명시적으로 지정 하려면 사용 하는 버전을 사용 하는 특별 한 이유가 없는 한 _findfirst 또는 _wfindfirst 또는 3 GB 보다 큰 파일 크기를 지원 해야 하는 경우 사용 _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> 또는 <wchar.h>
_wfindfirst32	<io.h> 또는 <wchar.h>
_wfindfirst64	<io.h> 또는 <wchar.h>
_wfindfirsti64	<io.h> 또는 <wchar.h>
_wfindfirst32i64	<io.h> 또는 <wchar.h>
_wfindfirst64i32	<io.h> 또는 <wchar.h>