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

O método IWbemBackupRestore::Restore exclui o conteúdo do repositório atual e os restaura com o conteúdo de um backup especificado anteriormente.

Como a WMI (Instrumentação de Gerenciamento do Windows) é o servidor dessa interface e deve ser interrompida para concluir essa operação com êxito, a conexão COM será interrompida se essa chamada for bem-sucedida.

Sintaxe

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

Parâmetros

[in] strRestoreFromFile

Cadeia de caracteres Unicode constante e terminada em nulo de caracteres Unicode de 16 bits que contém o nome do arquivo a ser restaurado. O arquivo especificado deve apontar para um arquivo criado anteriormente com IWbemBackupRestore::Backup.

[in] lFlags

Um dos sinalizadores a seguir da enumeração WBEM_BACKUP_RESTORE_FLAGS .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

Não desliga clientes ativos; retornará um erro se houver algum.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Desliga todos os clientes ativos.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido no HRESULT.

Comentários

O modo padrão é o mesmo que definir o sinalizador de modo de força, que interrompe todas as conexões ativas. Isso resulta em erros de RPC (chamada de procedimento remoto) de conexões COM ativas com o WMI até que novas conexões sejam estabelecidas.

Exemplos

O exemplo do C++ a seguir mostra como chamar o 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