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

Artículo
03/08/2023

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