Поделиться через

Код элемента управления FSCTL_GET_BOOT_AREA_INFO

  • Статья

Код FSCTL_GET_BOOT_AREA_INFO управления извлекает расположения загрузочных секторов для тома.

Для выполнения этой операции вызовите функцию FltFsControlFile или функцию ZwFsControlFile со следующими параметрами.

Параметры

  • FileObject [in]: только FltFsControlFile . Указатель файлового объекта для тома, для которого FSCTL_GET_BOOT_AREA_INFO будет получать сведения о загрузке. Этот параметр является обязательным и не может иметь значение NULL.

  • FileHandle [in]: только ZwFsControlFile . Дескриптор файла для тома, для которого FSCTL_GET_BOOT_AREA_INFO будет получать сведения о загрузке. Этот параметр является обязательным и не может иметь значение NULL.

    Этот дескриптор должен быть открыт с правами доступа SE_MANAGE_VOLUME_NAME. Дополнительные сведения см. в разделе Безопасность файлов и права доступа.

  • FsControlCode [in]: управляющий код для операции. Используйте FSCTL_GET_BOOT_AREA_INFO для этой операции.

  • InputBuffer [in]: не используется с этой операцией. Задайте значение NULL.

  • InputBufferLength [in]: не используется с этой операцией. Задайте нулевое значение.

  • OutputBuffer [out]: указатель на структуру BOOT_AREA_INFO , которая получает расположение загрузочных секторов тома.

  • OutputBufferLength [out]: размер выходного буфера в байтах.

Блок состояния

FltFsControlFile или ZwFsControlFile возвращает соответствующее значение NTSTATUS, например одно из следующих значений:

Код Значение
STATUS_SUCCESS Операция выполнена успешно. OutputBuffer содержит указатель на структуру BOOT_AREA_INFO .
STATUS_INVALID_PARAMETER Недопустимый параметр; Например, используемый дескриптор не является допустимым дескриптором тома.
STATUS_BUFFER_TOO_SMALL OutputBuffer недостаточно велик для результата. Никакие сведения не записаны в буфер.
STATUS_ACCESS_DENIED У пользователя нет доступа к SE_MANAGE_VOLUME.

Комментарии

FSCTL_GET_BOOT_AREA_INFO управляющий код можно использовать на устройствах FastFAT и exFAT. Эта возможность поддерживает использование BitLocker для устройств, таких как устройства флэш-памяти.

Требования

Тип требования Требование
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Заголовок Ntifs.h (включая Ntifs.h или Fltkernel.h)

См. также раздел

DeviceIoControl