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

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

  • Статья

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

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

Параметры

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

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

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

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

  • InputBuffer [in]: указатель на входной буфер, который должен содержать WOF_EXTERNAL_INFO структуру.

  • InputBufferLength [in]: задайте для параметра sizeof(WOF_EXTERNAL_INFO).

  • OutputBuffer [out]: указатель на выходной буфер, который получит одну или несколько WIM_PROVIDER_OVERLAY_ENTRY структур для источников данных, хватающих за том.

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

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

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

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

Код Значение
STATUS_ACCESS_DENIED Запрашивающий не имеет прав администратора.
STATUS_BUFFER_TOO_SMALL Длина выходного буфера, на который указывает OutputBuffer и задается outputBufferLength , слишком мала.
STATUS_INTERNAL_ERROR Запрошенный том недоступен.
STATUS_INVALID_DEVICE_REQUEST Резервная служба отсутствует или не запущена.

Комментарии

При перечислении источников данных для поставщика WIM выходной буфер будет содержать массив WIM_PROVIDER_OVERLAY_ENTRY структур. Размер выходного буфера должен быть достаточным, чтобы он содержал все записи наложения, иначе вызов вернет STATUS_BUFFER_TOO_SMALL.

Дополнительные резервные поставщики будут определять собственные структуры перечисления.

Требования

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

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

FltFsControlFile

ZwFsControlFile

FSCTL_ADD_OVERLAY

WOF_EXTERNAL_INFO