Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Код элемента управления FSCTL_REMOVE_OVERLAY удаляет резервный источник из тома.
Чтобы выполнить эту операцию, вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.
Параметры
Экземпляр [in]: только FltFsControlFile . Непрозрачный указатель экземпляра вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.
FileObject [in]: только FltFsControlFile . Объект указателя файла тома, из которого удаляется наложение. Этот параметр является обязательным и не может иметь значение NULL.
FileHandle [in]: только ZwFsControlFile . Дескриптор тома, для которого удаляется наложение. Этот параметр является обязательным и не может иметь значение NULL.
FsControlCode [in]: код элемента управления для операции. Используйте FSCTL_REMOVE_OVERLAY для этой операции.
InputBuffer [in]: указатель на входной буфер, который должен содержать структуру WOF_EXTERNAL_INFO . При необходимости дополнительные данные поставщика включаются сразу после WOF_EXTERNAL_INFO. Если поставщик является WIM-файлом , WIM_PROVIDER_REMOVE_OVERLAY_INPUT структура включается после WOF_EXTERNAL_INFO.
InputBufferLength [in]: задайте для sizeof(WOF_EXTERNAL_INFO) плюс размер любых дополнительных входных данных поставщика.
OutputBuffer [out]: не используется. Задайте значение NULL.
OutputBufferLength [in]: задайте значение 0.
Блок состояния
FltFsControlFile или ZwFsControlFile возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае соответствующая функция может вернуть одно из следующих значений NTSTATUS.
| Код | Значение |
|---|---|
| СТАТУС_ДОСТУП_ЗАПРЕЩЕН | Запрашиватель не имеет прав администратора. |
| STATUS_BUFFER_TOO_SMALL | Длина буфера вывода, на которую указывает OutputBuffer, и указанная OutputBufferLength, слишком мала. |
| СТАТУС_ВНУТРЕННЯЯ_ОШИБКА | Запрошенный том недоступен. |
| STATUS_INVALID_DEVICE_REQUEST | Служба резервного копирования отсутствует или не запущена. |
Замечания
При удалении резервного источника является файлом формата образов Windows (WIM), входной буфер будет содержать WOF_EXTERNAL_INFO структуру, за которой следует WIM_PROVIDER_REMOVE_OVERLAY_INPUT структура. InputBufferLength в этом случае будет sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Значение DataSourceId в WIM_PROVIDER_REMOVE_OVERLAY_INPUT должно быть для файла WIM, ранее добавленного в запросFSCTL_ADD_OVERLAY .
Дополнительные поставщики поддержки определяют собственные структуры входных параметров.
Требования
| Тип требования | Требование |
|---|---|
| Минимальный поддерживаемый клиент | Обновление для Windows 8.1 |
| Заголовок | Ntifs.h (включая Ntifs.h или Fltkernel.h) |