Функция GetFileType


Функция GetFileType извлекает тип файла для указанного файла.

Синтаксис

DWORD GetFileType(
  HANDLE hFile   // дескриптор файла
);

Параметры

hFile

[in] Дескриптор открытого файла.

Возвращаемые значения

Возвращаемое значение - одно из ниже перечисленных значений.

Значение

Предназначение

FILE_TYPE_CHAR Указанный файл - символьный файл, обычно устройства LPT или консоли.
FILE_TYPE_DISK Указанный файл - файл на диске.
FILE_TYPE_PIPE Указанный файл является или именованным или анонимным каналом.
FILE_TYPE_REMOTE Не используется.
FILE_TYPE_UNKNOWN Или тип указанного файла неизвестен, или функция завершилась ошибкой.

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

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

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

Смотри также

Обзор Управление файламиФункции, используемые в управлении файлами, GetFileSize, GetFileTime

Размещение и совместимость GetFileType
К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
 
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да
е    
р    
Используемая библиотека Kernel32.lib
Используемая DLL -
Заголовочный файл  
- объявлено в Winbase.h
- включено в Windows.h
Unicode Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz