Método IVssBackupComponents::SetAdditionalRestores (vsbackup.h)

  • Artículo

Un solicitante usa el método SetAdditionalRestores durante las operaciones de restauración incremental o diferencial para indicar a los escritores que un componente determinado requerirá operaciones de restauración adicionales para recuperarla por completo.

Sintaxis

HRESULT SetAdditionalRestores(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAdditionalRestores
);

Parámetros

[in] writerId

Identificador del escritor.

[in] ct

Tipo del componente. Consulte VSS_COMPONENT_TYPE para conocer los valores posibles.

[in] wszLogicalPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente que se va a agregar.

Para obtener más información, consulte Ruta de acceso lógica de componentes.

El valor de la cadena que contiene la ruta de acceso lógica usada aquí debe ser el mismo que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

La ruta de acceso lógica puede ser NULL.

No hay restricciones en los caracteres que pueden aparecer en una ruta lógica que no sea NULL .

[in] wszComponentName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del componente.

El valor de la cadena no debe ser NULL y debe contener el mismo componente que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

[in] bAdditionalRestores

Si el valor de este parámetro es true, las restauraciones adicionales del componente seguirán esta restauración. Si el valor es false, las restauraciones adicionales del componente no seguirán esta restauración.

Valor devuelto

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

Valor Significado
S_OK
 Establezca correctamente el estado de restauración adicional.
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_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
 El componente de copia de seguridad no existe.
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.
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.

Comentarios

Normalmente, los escritores usan la información proporcionada por el método SetAdditionalRestores que admiten un mecanismo de recuperación explícito como parte de su controlador de eventos PostRestore (CVssWriter::OnPostRestore), por ejemplo, las aplicaciones de base de datos y Exchange Server, 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 SetAdditionalRestores para un componente se establece en true, esto significa que dicho 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 en un componente se establece en false, después de restaurar el componente, la aplicación puede completar su operación de recuperación y volver a estar en línea.

Se debe llamar a este método antes de IVssBackupComponents::P reRestore.

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

Consulte también

IVssBackupComponents

IVssBackupComponents::P reRestore

VSS_COMPONENT_TYPE