Metodo IWbemBackupRestore::Restore (wbemcli.h)

Articolo
03/03/2024

Il metodo IWbemBackupRestore::Restore elimina il contenuto del repository corrente e li ripristina con il contenuto di un backup specificato in precedenza.

Poiché Strumentazione gestione Windows (WMI) è il server per questa interfaccia e deve essere arrestato per completare correttamente questa operazione, la connessione COM viene interrotta se questa chiamata ha esito positivo.

Sintassi

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

Parametri

[in] strRestoreFromFile

Stringa con terminazione null di caratteri Unicode a 16 bit che contiene il nome file del file da ripristinare. Il file specificato deve puntare a un file creato in precedenza con IWbemBackupRestore::Backup.

[in] lFlags

Uno dei flag seguenti dall'enumerazione WBEM_BACKUP_RESTORE_FLAGS .

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

Non arresta i client attivi; restituisce un errore se sono presenti.

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

Arresta tutti i client attivi.

Valore restituito

Questo metodo restituisce un HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto all'interno di HRESULT.

Commenti

La modalità predefinita corrisponde all'impostazione del flag force-mode, che interrompe tutte le connessioni attive. Ciò comporta errori di chiamata di routine remota (RPC) da connessioni COM attive a WMI, fino a quando non vengono stabilite nuove connessioni.

Esempio

Nell'esempio C++ seguente viene illustrato come chiamare il metodo 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
      );

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Wbemsvc.dll

Condividi tramite