IWbemBackupRestoreEx interface (wbemcli.h)
The IWbemBackupRestoreEx interface backs up and restores the contents of the repository. The affected content of the repository is static data, such as the class definitions that get compiled into the repository when a Managed Object Format (MOF) file is loaded. The dynamic data supplied through providers is not included. This interface adds the Pause and Resume methods to the functionality of IWbemBackupRestore.
Inheritance
The IWbemBackupRestoreEx interface inherits from IWbemBackupRestore. IWbemBackupRestoreEx also has these types of members:
Methods
The IWbemBackupRestoreEx interface has these methods.
| IWbemBackupRestoreEx::Pause The IWbemBackupRestoreEx::Pause method locks out write operations from the Windows Management Instrumentation (WMI) repository, and may cause read operations to be blocked. |
| IWbemBackupRestoreEx::Resume The IWbemBackUpRestoreEx::Resume method releases a lock on the Windows Management Instrumentation (WMI) repository so operations can continue. |
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.
The client making the call must have the correct privilege enabled. Backup requires the SE_RESTORE_NAME privilege, and 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.
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
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for