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

  • Artículo

El método GatherWriterMetadata solicita a cada escritor que envíe los metadatos que han recopilado. El método generará un evento Identify para comunicarse con escritores.

Sintaxis

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

Parámetros

[out] pAsync

Puntero indirecto doblemente a un objeto IVssAsync que contiene los metadatos 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_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.
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.

Comentarios

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

Se debe llamar a GatherWriterMetadata solo una vez durante la vigencia de un objeto IVssBackupComponents determinado.

GatherWriterMetadata genera un evento Identify, que se controla mediante cada instancia de cada escritor a través del método CVssWriter::OnIdentify , que se usa para rellenar el documento de metadatos del escritor.

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

CVssWriter::OnIdentify

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents