Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Код элемента управления 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_BUFFER_TOO_SMALL | Длина буфера вывода, на которую указывает OutputBuffer , и указанная OutputBufferLength , слишком мала. |
| СТАТУС_ВНУТРЕННЯЯ_ОШИБКА | Запрошенный том недоступен. |
| STATUS_INVALID_DEVICE_REQUEST | Служба резервного копирования отсутствует или не запущена. |
Замечания
При перечислении источников данных для поставщика WIM выходной буфер будет содержать массив WIM_PROVIDER_OVERLAY_ENTRY структур. Размер выходного буфера должен быть достаточно большим, чтобы содержать все записи наложения или вызов вернет STATUS_BUFFER_TOO_SMALL.
Дополнительные поставщики поддержки определяют собственные структуры перечисления.
Требования
| Тип требования | Требование |
|---|---|
| Минимальный поддерживаемый клиент | Обновление для Windows 8.1 |
| Заголовок | Ntifs.h (включая Ntifs.h или Fltkernel.h) |