Export (0) Print
Expand All

IWbemBackupRestoreEx interface

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.

Members

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

Methods

The IWbemBackupRestoreEx interface has these methods.

MethodDescription
Backup

Backs up and restores the contents of the repository to and from a specified file.

Pause

Locks out write operations from the WMI repository.

Restore

Backs up and restores the contents of the repository to and from a specified file.

Resume

Releases the lock on the WMI repository so that operations can continue as normal.

 

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Wbemsvc.dll

See also

COM API for WMI

 

 

Show:
© 2014 Microsoft