Функция GetFileInformationByHandle

Функция GetFileInformationByHandle извлекает информацию о файле для указанного файла.

Синтаксис

BOOL GetFileInformationByHandle(
  HANDLE hFile,                                  // дескриптор файла
  LPBY_HANDLE_FILE_INFORMATION lpFileInformation // буфер
);

Параметры

hFile

[in] Дескриптор файла,  из которого получаем информацию.

Этот дескриптор не должен быть дескриптором канала (абстрактного файла). Функция GetFileInformationByHandle не работает с дескрипторами каналов.

lpFileInformation

[out] Указатель на структуру BY_HANDLE_FILE_INFORMATION, которая получает данные файла. Структура может использоваться в последующих вызовах функции GetFileInformationByHandle, чтобы обратиться к информации о файле.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.

Замечания

В зависимости от основных компонентов сети операционной системы и типа сервера соединения, функция GetFileInformationByHandle может завершиться ошибкой, возвратить частичную информацию или полную информацию для данного файла. Вообще то, вам не следует использовать GetFileInformationByHandle, если ваше приложение не предназначено, чтобы запускаться в конфигурации ограниченной установки операционной  системы.

Смотри также 

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

Размещение и совместимость GetFileInformationByHandle

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да 

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL -
Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

Нет

 Замечания по платформе

Не имеется

 

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

Hosted by uCoz