Compartir a través de


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

El método BackupComplete hace que VSS genere un evento BackupComplete , que indica a los escritores que se ha completado el proceso de copia de seguridad.

Sintaxis

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

Parámetros

[out] ppAsync

Puntero indirecto doble a una instancia IVssAsync .

Valor devuelto

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

Value Significado
S_OK
Devolvió correctamente un puntero a una instancia de la interfaz IVssAsync . Consulte IVssAsync::QueryStatus para conocer los valores válidos devueltos por el parámetro pHrResult .
E_INVALIDARG
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, vea 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_WRITER_ERROR
Error inesperado durante la comunicación con escritores. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Comentarios

Al trabajar en modo de componente (se llamó a IVssBackupComponents::SetBackupState con un argumento select components de TRUE), los escritores pueden determinar el éxito o error de la copia de seguridad de cualquier componente incluido explícitamente en los componentes del documento componentes de copia de seguridad mediante IVssComponent::GetBackupSucceeded. Por lo tanto, una aplicación de copia de seguridad (solicitante) con buen comportamiento debe llamar a IVssBackupComponents::SetBackupSucceeded después de procesar cada componente y antes de llamar a BackupComplete.

No llame a este método si se produjo un error en la llamada a IVssBackupComponents::D oSnapshotSet . Para obtener más información sobre cómo los solicitantes usan DoSnapshotSet, SetBackupSucceeded yBackupComplete en una operación de copia de seguridad, vea Overview of Pre-Backup Tasks and Overview of Real Backup Of Files.

Esta operación es asincrónica. El llamador puede usar el método de interfaz QueryStatus en la interfaz IVssAsync devuelta para determinar el estado de la notificación.

Después de llamar a BackupComplete, los solicitantes deben llamar a GatherWriterStatus para que la sesión de escritor se establezca en un estado completado.

Nota Esto solo es necesario en Windows Server 2008 con Service Pack 2 (SP2) y versiones anteriores.
 
La aplicación de copia de seguridad puede optar por anular la copia de seguridad en cualquier momento después de crear la instantánea llamando a IVssAsync::Cancel.

La aplicación de llamada es responsable de llamar a IUnknown::Release para liberar los recursos mantenidos por los IVssAsync devueltos cuando ya no es necesario.

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

IVssAsync

IVssAsync::Cancel

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::SetBackupState

IVssBackupComponents::SetBackupSucceed