GetFileType 함수(fileapi.h)

지정된 파일의 파일 유형을 검색합니다.

구문

DWORD GetFileType(
  [in] HANDLE hFile
);

매개 변수

[in] hFile

파일에 대한 핸들입니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

반환 코드/값	설명
FILE_TYPE_CHAR 0x0002	지정된 파일은 문자 파일( 일반적으로 LPT 디바이스 또는 콘솔)입니다.
FILE_TYPE_DISK 0x0001	지정된 파일이 디스크 파일입니다.
FILE_TYPE_PIPE 0x0003	지정된 파일은 소켓, 명명된 파이프 또는 익명 파이프입니다.
FILE_TYPE_REMOTE 0x8000	사용되지 않습니다.
FILE_TYPE_UNKNOWN 0x0000	지정된 파일의 형식을 알 수 없거나 함수가 실패했습니다.

 

GetLastError를 호출하여 호출 오류(예: GetFileType에 잘못된 핸들 전달)로 인해 FILE_TYPE_UNKNOWN "유효한" 반환과 반환을 구분할 수 있습니다.

함수가 제대로 작동하고 FILE_TYPE_UNKNOWN 반환된 경우 GetLastError 호출은 NO_ERROR 반환합니다.

GetFileType 호출 오류로 인해 함수가 FILE_TYPE_UNKNOWN 반환하는 경우 GetLastError는 오류 코드를 반환합니다.

설명

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	Yes
SMB 3.0 TFO(투명 장애 조치(failover))	Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	Yes
CsvFS(클러스터 공유 볼륨 파일 시스템)	Yes
ReFS(Resilient File System)	Yes

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	fileapi.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

파일 관리 함수

GetFileSize

GetFileTime