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 code | Description |
|---|---|
|
Requested operation is not valid. |
|
User does not have the right to perform this. For more information, see Maintaining WMI Security. |
|
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 [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 11/19/2012