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