Método IVssComponent::GetAdditionalRestores (vswriter.h)

  • Artículo

Un escritor usa el método GetAdditionalRestores durante las operaciones de restauración incremental o diferencial para determinar si un componente determinado requerirá operaciones de restauración adicionales para recuperarla por completo.

Un escritor o un solicitante pueden llamar a este método.

Sintaxis

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Parámetros

[out] pbAdditionalRestores

Dirección de una variable asignada por el autor de la llamada que recibe true si se producirán restauraciones adicionales para el componente actual o false en caso contrario.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 Devolvió correctamente el valor del atributo.
S_FALSE
 El atributo especificado no tiene un valor.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
 El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS.

Comentarios

El valor devuelto por GetAdditionalRestores será false, a menos que durante una operación de restauración un solicitante llame a IVssBackupComponents::SetAdditionalRestores.

GetAdditionalRestores debe usarse para comprobar si es necesario usar más de un conjunto de copia de seguridad para restaurar completamente un componente. Un componente se puede recuperar primero restaurando los datos de una copia de seguridad completa y actualizando esos datos de una o varias copias de seguridad incrementales o diferenciales posteriores.

Normalmente, los escritores usan el método GetAdditionalRestores que admiten un mecanismo de recuperación explícito como parte de su controlador de eventos PostRestore (CVssWriter::OnPostRestore), por ejemplo, los Exchange Server y las aplicaciones de base de datos, como SQL Server. Para estas aplicaciones, a menudo no es posible realizar restauraciones diferenciales, incrementales o de registro adicionales después de realizar dicha recuperación.

Por lo tanto, si GetAdditionalRestores devuelve true para un componente, este escritor no debe ejecutar su mecanismo de recuperación explícito y debe esperar que se realicen restauraciones diferenciales, incrementales o de registro adicionales.

Cuando SetAdditionalRestores devuelve false, una vez finalizada la restauración, al controlar el evento PostRestore , el escritor puede completar su operación de recuperación y volver a estar en línea.

Requisitos

   
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 vswriter.h (incluya Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssComponent