Метод IWbemBackupRestore::Restore (wbemcli.h)

Статья
03/03/2024

Метод IWbemBackupRestore::Restore удаляет содержимое текущего репозитория и восстанавливает его с содержимым ранее указанной резервной копии.

Так как инструментарий управления Windows (WMI) является сервером для этого интерфейса и должен быть остановлен для успешного завершения этой операции, в случае успешного вызова COM-подключение будет прервано.

Синтаксис

HRESULT Restore(
  [in] LPCWSTR strRestoreFromFile,
  [in] long    lFlags
);

Параметры

[in] strRestoreFromFile

Константная строка, завершающаяся нулевым значением, из 16-разрядных символов Юникода, содержащая имя файла для восстановления. Указанный файл должен указывать на файл, ранее созданный с помощью IWbemBackupRestore::Backup.

[in] lFlags

Один из следующих флагов из перечисления WBEM_BACKUP_RESTORE_FLAGS .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

Не завершает работу активных клиентов; возвращает ошибку, если таковые имеются.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Завершает работу всех активных клиентов.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.

Режим по умолчанию совпадает с установкой флага принудительного режима, который прерывает все активные подключения. Это приводит к ошибкам удаленного вызова процедур (RPC) от активных COM-подключений к WMI до тех пор, пока не будут установлены новые подключения.

Примеры

В следующем примере C++ показано, как вызвать метод IWbemBackupRestore::Restore .

// The pInt variable is of type IWbemBackupRestore*
pInt->Restore(
        L"c:\\\\Windows\\System32\\wbem\\repository\\back.x",
        WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN
      );

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Wbemsvc.dll

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