Edit

Share via

IWbemBackupRestore interface (wbemcli.h)

  • Article

The IWbemBackupRestore interface backs up and restores the contents of the WMI repository. The affected content of the repository is static data, such as the class definitions that are compiled into the repository when a MOF file is loaded. The dynamic data supplied through providers is not included.

Inheritance

The IWbemBackupRestore interface inherits from the IUnknown interface. IWbemBackupRestore also has these types of members:

Methods

The IWbemBackupRestore interface has these methods.

 
IWbemBackupRestore::Backup

The IWbemBackupRestore::Backup method backs up the contents of the static repository to a separate file.
IWbemBackupRestore::Restore

The IWbemBackupRestore::Restore method deletes the contents of the current repository and restores them with the contents of a previously specified backup.

Remarks

The default mode is the same as setting the force mode flag, which breaks all active connections. This results in remote procedure call (RPC) errors from any active COM connections to WMI until new connections are established.

There can be no active connections to the repository during a restore operation. For this reason, the restore operation fails if default parameters are used and there are active connections. A flag can be specified to break all active connections.

Note  The client making the call must have the proper privilege enabled. Backup requires the SE_RESTORE_NAME privilege, while restoration requires SE_RESTORE_NAME. To enable a privilege, a client application must be running under a user account that has that privilege, and the privilege must be enabled using the Windows AdjustTokenPrivileges function.
 
For computers running Windows, any local user can make these calls, but remote users must have the WBEM_FULL_WRITE_REP access right to the root namespace.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header wbemcli.h (include Wbemidl.h)

See also

COM API for WMI