IWbemBackupRestoreEx::Pause method

The IWbemBackupRestoreEx::Pause method locks out write operations from the Windows Management Instrumentation (WMI) repository, and may cause read operations to be blocked.

Syntax


HRESULT Pause();

Parameters

This method has no parameters.

Return value

This method returns an HRESULT that indicates the status of a method call. The following list lists the values contained within an HRESULT.

WBEM_E_INVALID_OPERATION

Requested operation is not valid.

WBEM_E_ACCESS_DENIED

User does not have the right to perform this. For more information, see Maintaining WMI Security.

S_OK

Method succeeded.

Remarks

When implementing the Pause method, the Resume method should be called as soon as possible. If Resume is not called within fifteen (15) minutes, it is called automatically for you. Calling Pause two times on the same object without calling Resume first will fail. Calling Pause on two objects at the same time may cause the second object to lock up until Resume is called on the first object.

Note  To implement the Pause method, the client user must have SE_BACKUP_NAME prior to calling the method.
 

Examples

The following C++ example shows how to correctly call the IWbemBackupRestoreEx::Pause method.


// The pInt variable is of type IWbemBackupRestoreEx*
pInt->Pause();

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Wbemsvc.dll

See also

IWbemBackupRestoreEx

 

 

Show: