Método IVssComponent::GetBackupMetadata (vswriter.h)
El método GetBackupMetadata recupera metadatos de copia de seguridad privados específicos del escritor que podrían haberse establecido durante un evento PrepareForBackup por parte de CVssWriter::OnPrepareBackup mediante IVssComponent::SetBackupMetadata.
Solo un escritor puede llamar a este método.
Sintaxis
HRESULT GetBackupMetadata(
[out] BSTR *pbstrData
);
Parámetros
[out] pbstrData
Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene los metadatos de copia de seguridad que se agregaron durante un evento OnPrepareBackup .
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
Valor | Significado |
---|---|
|
Se devolvió correctamente el valor del atributo. |
|
No hay metadatos de copia de seguridad asociados a este componente. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, vea Control de eventos y errores en VSS. |
Comentarios
Se puede llamar a este método en cualquier momento en función de la lógica de un sistema de escritura determinado.
Si no se ha establecido ningún metadato de copia de seguridad, GetBackupMetadata devuelve S_FALSE.
Si la llamada a GetBackupMetadata se realiza correctamente, el autor de la llamada es responsable de liberar la cadena que se devuelve en el parámetro pbstrMetadata mediante una llamada a la función SysFreeString .
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 | vswriter.h (incluye Vss.h, VsWriter.h) |
Library | VssApi.lib |