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

Код элемента управления FSCTL_SUSPEND_OVERLAY приостанавливает резервный источник, подключенный к тому, предотвращая доступ к резервному источнику и позволяя изменять или удалять его.

Чтобы выполнить эту операцию, вызовите FltFsControlFile или ZwFsControlFile со следующими параметрами.

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        FSCTL_SUSPEND_OVERLAY, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                    (LPDWORD)      lpOutBuffer,     // output buffer
                    (DWORD)        nOutBufferSize,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Параметры

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

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

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

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

  • InputBuffer [in]: указатель на входной буфер, который должен содержать структуру WOF_EXTERNAL_INFO . При необходимости дополнительные данные поставщика включаются сразу после WOF_EXTERNAL_INFO. Если поставщик является WIM-файлом , WIM_PROVIDER_SUSPEND_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 Длина входного буфера, на которую указывает InputBuffer, и указанная inputBufferLength, слишком мала.
СТАТУС_ВНУТРЕННЯЯ_ОШИБКА Запрошенный том недоступен.
STATUS_INVALID_DEVICE_REQUEST Служба резервного копирования отсутствует или не запущена.

Замечания

При удалении резервного источника является файлом формата образов Windows (WIM), входной буфер будет содержать WOF_EXTERNAL_INFO структуру , за которой следует WIM_PROVIDER_SUSPEND_OVERLAY_INPUT структура. InputBufferLength в этом случае будет sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT). Значение DataSourceId в WIM_PROVIDER_SUSPEND_OVERLAY_INPUT должно быть для ФАЙЛА WIM, ранее добавленного в запросFSCTL_ADD_OVERLAY .

Дополнительные поставщики поддержки определяют собственные структуры входных параметров.

Требования

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

См. также

FSCTL_REMOVE_OVERLAY

FSCTL_UPDATE_OVERLAY

FSCTL_GET_EXTERNAL_BACKING

FSCTL_SET_EXTERNAL_BACKING

  • Last updated on