Функция 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