Método IVssBackupComponents::Query (vsbackup.h)
El método Query consulta proveedores en el sistema o las instantáneas completadas en el sistema que residen en el contexto actual. Solo se puede llamar al método durante las operaciones de copia de seguridad.
Sintaxis
HRESULT Query(
[in] VSS_ID QueriedObjectId,
[in] VSS_OBJECT_TYPE eQueriedObjectType,
[in] VSS_OBJECT_TYPE eReturnedObjectsType,
[out] IVssEnumObject **ppEnum
);
Parámetros
[in] QueriedObjectId
Reservado. El valor de este parámetro debe ser GUID_NULL.
[in] eQueriedObjectType
Indica la restricción de la consulta al tipo de objeto especificado. Un valor de VSS_OBJECT_NONE indica que no hay ninguna restricción, es decir, se consultarán todos los objetos.
Actualmente, el valor de este parámetro debe ser VSS_OBJECT_NONE.
[in] eReturnedObjectsType
Tipos de objeto que se van a devolver. El valor de este parámetro debe ser VSS_OBJECT_SNAPSHOT o VSS_OBJECT_PROVIDER.
[out] ppEnum
Puntero indirecto doble a un objeto enumerador IVssEnumObject .
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Devolvió correctamente un puntero a una instancia de la interfaz IVssEnumObject . |
|
El autor de la llamada no es un administrador ni un operador de copia de seguridad. |
|
Uno de los valores de parámetro no es válido. |
|
Memoria insuficiente u otros recursos del sistema. |
|
El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
|
No se encuentra el objeto consultado. |
|
Se esperaba un error de proveedor. El proveedor registró el error en el registro de eventos. Para obtener más información, consulte Control de eventos y errores en VSS. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar. |
|
Error inesperado del proveedor. El código de error se registra en el registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS. |
Comentarios
Dado que Query solo devuelve información sobre las instantáneas completadas, el único estado de instantánea que puede revelar es VSS_SS_COMPLETED.
El método solo se puede llamar durante las operaciones de copia de seguridad y debe ir precedido por llamadas a IVssBackupComponents::InitializeForBackup e IVssBackupComponents::SetContext.
Aunque Query puede devolver información sobre todos los proveedores disponibles en un sistema, solo devolverá información sobre instantáneas con el contexto actual (establecido por IVssBackupComponents::SetContext). Por ejemplo, si el contexto de _VSS_SNAPSHOT_CONTEXT está establecido en VSS_CTX_BACKUP, Query no devolverá información sobre una instantánea creada con un contexto de VSS_CTX_FILE_SHARE_BACKUP.
Aunque este método devuelve actualmente una lista de todos los proveedores disponibles o todas las instantáneas completadas, en el futuro, se pueden admitir consultas especializadas: por ejemplo, consultar todas las instantáneas asociadas a un proveedor.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |
Consulte también
IVssBackupComponents::InitializeForBackup