Функция 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	Тип указанного файла неизвестен, либо функция завершилась сбоем.

 

Вы можете различать "допустимое" возвращение FILE_TYPE_UNKNOWN и его возврат из-за ошибки вызова (например, передачи недопустимого дескриптора в GetFileType), вызвав Метод GetLastError.

Если функция работала правильно и FILE_TYPE_UNKNOWN была возвращена, вызов GetLastError вернет NO_ERROR.

Если функция вернула FILE_TYPE_UNKNOWN из-за ошибки при вызове GetFileType, GetLastError вернет код ошибки.

Комментарии

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Да
SMB 3.0 Transparent Failover (TFO)	Да
SMB 3.0 с масштабируемыми общими папками (SO)	Да
Файловая система общего тома кластера (CSVFS)	Да
Восстанавливаемая файловая система (ReFS)	Да

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	fileapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Функции управления файлами

GetFileSize

GetFileTime