IVssBackupComponents::Query method (vsbackup.h)
The Query method queries providers on the system and/or the completed shadow copies in the system that reside in the current context. The method can be called only during backup operations.
Syntax
HRESULT Query(
[in] VSS_ID QueriedObjectId,
[in] VSS_OBJECT_TYPE eQueriedObjectType,
[in] VSS_OBJECT_TYPE eReturnedObjectsType,
[out] IVssEnumObject **ppEnum
);
Parameters
[in] QueriedObjectId
Reserved. The value of this parameter must be GUID_NULL.
[in] eQueriedObjectType
Indicates restriction of the query to the given object type. A value of VSS_OBJECT_NONE indicates no restriction—that is, all objects will be queried.
Currently, the value of this parameter must be VSS_OBJECT_NONE.
[in] eReturnedObjectsType
Object types to be returned. The value of this parameter must be either VSS_OBJECT_SNAPSHOT or VSS_OBJECT_PROVIDER.
[out] ppEnum
Doubly indirect pointer to an IVssEnumObject enumerator object.
Return value
The following are the valid return codes for this method.
| Value | Meaning |
|---|---|
|
Successfully returned a pointer to an instance of the IVssEnumObject interface. |
|
The caller is not an administrator or a backup operator. |
|
One of the parameter values is not valid. |
|
Out of memory or other system resources. |
|
The backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence. |
|
The queried object is not found. |
|
Expected provider error. The provider logged the error in the event log. For more information, see Event and Error Handling Under VSS. |
|
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. |
|
Unexpected provider error. The error code is logged in the error log. For more information, see Event and Error Handling Under VSS. |
Remarks
Because Query returns only information on completed shadow copies, the only shadow copy state it can disclose is VSS_SS_COMPLETED.
The method may be called only during backup operations and must be preceded by calls to IVssBackupComponents::InitializeForBackup and IVssBackupComponents::SetContext.
While Query can return information on all of the providers available on a system, it will return only information about shadow copies with the current context (set by IVssBackupComponents::SetContext). For instance, if the _VSS_SNAPSHOT_CONTEXT context is set to VSS_CTX_BACKUP, Query will not return information on a shadow copy created with a context of VSS_CTX_FILE_SHARE_BACKUP.
While this method currently returns a lists of all available providers and/or all completed shadow copies, in the future, specialized queries may be supported: for instance, querying all shadow copies associated with a provider.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |
See also
IVssBackupComponents::InitializeForBackup