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

код элемента управления FSCTL_GET_EXTERNAL_BACKING

  • Статья

Код элемента управления FSCTL_GET_EXTERNAL_BACKING получает сведения о резервном копировании файла от внешнего поставщика резервной поддержки. К резервным поставщикам относятся поставщик wim или отдельный поставщик сжатых файлов. Содержимое для файлов с внешней поддержкой может находиться на томах, отличных от тома, содержащего запрашиваемый файл.

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

Параметры

  • Экземпляр [in]: только FltFsControlFile . Указатель непрозрачного экземпляра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.

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

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

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

  • InputBuffer [in]: нет. Задайте значение NULL.

  • InputBufferLength [in]: задайте значение 0.

  • OutputBuffer [out]: указатель на выходной буфер, размер которого должен быть достаточно большим, чтобы получить структуру WOF_EXTERNAL_INFO , за которой следуют данные поставщика. Для файлов с поддержкой WIM WOF_EXTERNAL_INFO следует структура WIM_PROVIDER_EXTERNAL_INFO . За WOF_EXTERNAL_INFO для отдельных сжатых файлов следует структура FILE_PROVIDER_EXTERNAL_INFO_V1 .

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

  • LengthReturned [out]: указывает количество байтов, записанных в OutputBuffer при успешном завершении.

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

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

Код Значение
STATUS_OBJECT_NOT_EXTERNALLY_BACKED Файл не поддерживается извне.
STATUS_INVALID_DEVICE_REQUEST Резервная служба отсутствует или не запущена.

Комментарии

Если резервным поставщиком для обновляемого источника данных является WIM-файл, выходной буфер будет содержать структуру WOF_EXTERNAL_INFO , за которой следует структура WIM_PROVIDER_EXTERNAL_INFO . Значение OutputBufferLength должно быть не менее sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO). Если резервным поставщиком является отдельный сжатый файл, выходной буфер будет содержать WOF_EXTERNAL_INFO структуру, за которой следует структура FILE_PROVIDER_EXTERNAL_INFO_V1 .

Требования

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

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

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING

WIM_PROVIDER_EXTERNAL_INFO

WOF_EXTERNAL_INFO