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
S_OK	Devolvió correctamente un puntero a una instancia de la interfaz IVssEnumObject .
E_ACCESSDENIED	El autor de la llamada no es un administrador ni un operador de copia de seguridad.
E_INVALIDARG	Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY	Memoria insuficiente u otros recursos del sistema.
VSS_E_BAD_STATE	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.
VSS_E_OBJECT_NOT_FOUND	No se encuentra el objeto consultado.
VSS_E_PROVIDER_VETO	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.
VSS_E_UNEXPECTED	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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	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

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::SetContext

IVssEnumObject