Compartir a través de

Método IVssBackupComponents::P reRestore (vsbackup.h)

  • Artículo

El método PreRestore hará que VSS genere un evento PreRestore y los escritores de señalización se preparen para una próxima operación de restauración.

Sintaxis

HRESULT PreRestore(
  [out] IVssAsync **ppAsync
);

Parámetros

[out] ppAsync

Puntero indirecto doble a un objeto IVssAsync que contiene datos de estado para el evento señalado.

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 IVssAsync . Consulte IVssAsync::QueryStatus para ver los códigos de error devueltos en el parámetro pHrResult .
E_INVALIDARG
 El parámetro ppAsync no apunta a un puntero válido; es decir, es NULL.
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_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

El autor de la llamada es responsable de liberar el puntero de interfaz IVssAsync .

Se debe tener en cuenta especial a los sistemas EFI cuando el solicitante haya seleccionado el escritor de recuperación automática del sistema (ASR) para la restauración. Si va a restaurar en un disco que contiene la partición EFI y existe una de las siguientes condiciones, primero debe limpiar el disco llamando al método IVdsAdvancedDisk::Clean :

  • Va a restaurar en un disco del sistema EFI cuya creación de particiones ha cambiado desde la última copia de seguridad de ASR.
  • Va a restaurar en una unidad física diferente a la de la que se realizó la copia de seguridad.
Si no se realiza este paso de limpieza de disco, se pueden producir resultados inesperados durante PreRestore.

Para obtener más información sobre el escritor de ASR, vea VsS Writer in-Box.

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

IVssAsync

IVssBackupComponents