IVssAsync::QueryStatus method (vss.h)
The QueryStatus method queries the status of an asynchronous operation.
Syntax
HRESULT QueryStatus(
[out] HRESULT *pHrResult,
[out] INT *pReserved
);
Parameters
[out] pHrResult
The status of the asynchronous operation that returned the current IVssAsync object.
All calls to QueryStatus for all IVssAsync objects support the following status codes.
| Value | Meaning |
|---|---|
|
The asynchronous operation was canceled by a previous call to IVssAsync::Cancel. |
|
The asynchronous operation was completed successfully. |
|
The asynchronous operation is still running. |
Additional return values can be returned, but depend on the return codes of the method that initially returned the IVssAsync object.
[out] pReserved
The value of this parameter should be NULL.
Return value
The following are the valid return codes for this method.
| Value | Meaning |
|---|---|
|
The query operation was successful. |
|
The query operation failed because the user did not have the correct privileges. |
|
The pointer to the variable used to hold the pHrResult return value is NULL or is not a valid memory location. |
|
Unexpected error. The error code is logged in the error log file. For more information, see
Event and Error Handling Under VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP: This value is not supported until Windows Server 2008 R2 and Windows 7. E_UNEXPECTED is used instead. |
Remarks
In the event of an error during the course of an asynchronous operation, QueryStatus will return the same error code as the method that initially returned the IVssAsync object.
To obtain a complete list of return values for an IVssAsync::QueryStatus object returned by a specific method, see the error codes documented for that method.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | vss.h |
| Library | VssApi.lib |
See also
IVssBackupComponents::DoSnapshotSet
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::GatherWriterStatus
IVssBackupComponents::ImportSnapshots
IVssBackupComponents::PostRestore