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

Artículo
03/03/2024

El método PrepareForBackup hará que VSS genere un evento PrepareForBackup y los escritores de señalización se preparen para una próxima operación de copia de seguridad. Esto hace que el documento de componentes de copia de seguridad de un solicitante esté disponible para escritores.

Sintaxis

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

Parámetros

[out] ppAsync

Puntero indirecto doble a una instancia de la interfaz IVssAsync que se usa para determinar cuándo se completa la operación asincrónica.

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	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

PrepareForBackup genera un evento PrepareForBackup, que se controla mediante cada instancia de cada escritor a través del método CVssWriter::OnPrepareBackup .

Antes de llamar a PrepareForBackup , se debe llamar a IVssBackupComponents::SetBackupState .

El documento componentes de copia de seguridad todavía se puede modificar por escritores en su controlador de eventos PrepareForBackup (CVssWriter::OnPrepareBackup) y después hasta la generación de un evento BackupComplete .

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

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