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


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

Код элемента управления FSCTL_DELETE_EXTERNAL_BACKING удаляет связь файла с внешним резервным поставщиком, включая поставщик wim или сжатый файл. В результате этой операции все содержимое файла с резервной копией считывается, распаковывается и записывается в файл.

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

Параметры

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

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

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

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

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

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

  • OutputBuffer [out]: нет. задано значение NULL.

  • OutputBufferLength [out]: задайте значение 0.

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

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

Код Значение
STATUS_OBJECT_NOT_EXTERNALLY_BACKED Файл не поддерживается извне.
STATUS_INVALID_DEVICE_REQUEST Резервная служба отсутствует или не запущена.
STATUS_ACCESS_DENIED Инициатор запроса не имеет разрешения на удаление резервных сопоставлений для файла.

Комментарии

В результате операции удаления содержимое файла считывается из резервного источника и весь файл записывается в том.

Требования

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

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

FltFsControlFile

ZwFsControlFile

FSCTL_SET_EXTERNAL_BACKING