Método IWbemBackupRestore::Restore (wbemcli.h)

  • Artículo

El método IWbemBackupRestore::Restore elimina el contenido del repositorio actual y los restaura con el contenido de una copia de seguridad especificada anteriormente.

Dado que Instrumental de administración de Windows (WMI) es el servidor de esta interfaz y debe detenerse para completar esta operación correctamente, la conexión COM se interrumpe si esta llamada se realiza correctamente.

Sintaxis

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

Parámetros

[in] strRestoreFromFile

Constante, cadena terminada en null de caracteres Unicode de 16 bits que contiene el nombre de archivo del archivo que se va a restaurar. El archivo especificado debe apuntar a un archivo creado anteriormente con IWbemBackupRestore::Backup.

[in] lFlags

Una de las marcas siguientes de la enumeración WBEM_BACKUP_RESTORE_FLAGS .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

No cierra los clientes activos; devuelve un error si hay alguno.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Cierra los clientes activos.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en HRESULT.

Comentarios

El modo predeterminado es el mismo que establecer la marca force-mode, que interrumpe todas las conexiones activas. Esto produce errores de llamada a procedimiento remoto (RPC) de conexiones COM activas a WMI, hasta que se establecen nuevas conexiones.

Ejemplos

En el siguiente ejemplo de C++ se muestra cómo llamar al método 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
      );

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo DLL Wbemsvc.dll