Export (0) Print
Expand All

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 table lists the values contained within an HRESULT.

Return codeDescription
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

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application 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 XP

Minimum supported server

Windows Server 2003

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Wbemsvc.dll

See also

IWbemBackupRestoreEx

 

 

Show:
© 2014 Microsoft