код элемента управления 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) |