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에서 이 함수는 다음 기술을 통해 지원됩니다.