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

El método GatherWriterStatus solicita a cada escritor que envíe un mensaje de estado.

Sintaxis

HRESULT GatherWriterStatus(
  [out] IVssAsync **pAsync
);

Parámetros

[out] pAsync

Puntero indirecto doble a un objeto IVssAsync que contiene los datos de estado del escritor.

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 conocer los valores válidos devueltos por el parámetro pHrResult .
E_ACCESSDENIED
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador.
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_WRITER_INFRASTRUCTURE
La infraestructura del sistema de escritura no funciona correctamente. Compruebe que se han iniciado el servicio de eventos y VSS y compruebe si hay errores asociados a esos servicios en el registro de errores.

Comentarios

El autor de la llamada de este método también debe llamar a IVssBackupComponents::FreeWriterStatus después de recibir el estado de cada escritor.

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 clase CVssWriter controla el mensaje de estado enviado por cada escritor.

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

Consulte también

CVssWriter

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::FreeWriterStatus