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

Artículo
08/27/2023

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