Share via

3.1.4.10.1 IWbemBackupRestore::Backup (Opnum 3)

  • Article

On the IWbemBackupRestore::Backup method invocation, the server MUST back up the contents of the CIM database.

 HRESULT Backup(
   [in, string] LPCWSTR strBackupToFile,
   [in] long lFlags
 );

strBackupToFile: MUST be a UTF-16 string, which MUST contain the name of the file to which the CIM database is backed up. This parameter MUST NOT<58> be NULL.

lFlags:  This parameter is not used, and its value MUST be 0x0.

Return Values: This method MUST return an HRESULT value that MUST indicate the status of the method call. The server MUST return WBEM_S_NO_ERROR (specified in section 2.2.11) to indicate the successful completion of the method.

In case of failure, the server MUST return an HRESULT whose S (severity) bit is set as specified in [MS-ERREF] section 2.1. The actual HRESULT value is implementation dependent.

WBEM_S_NO_ERROR (0x00)

The IWbemBackupRestore::Backup method MUST be called on the interface that is obtained from the DCOM Remote Protocol activation of a CLSID_WbemBackupRestore interface, as specified in this section.

In response to the IWbemBackupRestore::Backup method, the server MUST set the BackupInProgress flag to True. The server MUST back up the CIM database in a file that is specified in the strBackupToFile parameter. The server SHOULD<59> verify that the security principal making the call is allowed to back up the CIM database using implementation-specific authorization policy. If the security principal is not authorized, the server MUST return WBEM_E_ACCESS_DENIED.

The Backup operation MUST NOT impact the state of the incoming calls. After the Backup operation is complete, the server MUST set the BackupInProgress flag to False.