Método IVssComponent::GetRestoreMetadata (vswriter.h)
El método GetRestoreMetadata recupera metadatos de restauración privados específicos del escritor que podrían haberse establecido durante un evento PreRestore por parte de CVssWriter::OnPreRestore mediante IVssComponent::SetRestoreMetadata.
Solo un escritor puede llamar a este método.
Sintaxis
HRESULT GetRestoreMetadata(
[out] BSTR *pbstrRestoreMetadata
);
Parámetros
[out] pbstrRestoreMetadata
Cadena que contiene los metadatos de restauración.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Value | Significado |
|---|---|
|
Se devolvió correctamente el valor del atributo. |
|
El atributo especificado no tiene un valor. |
|
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.
El autor de la llamada debe liberar la memoria que mantiene el parámetro pbstrRestoreMetadata mediante una llamada a SysFreeString.
Si no se ha establecido ningún metadato de copia de seguridad, GetBackupMetadata devuelve S_FALSE.
Un escritor que establece el método de restauración en VSS_RME_RESTORE_TO_ALTERNATE_LOCATION sin definir una asignación de ubicación alternativa constituye un error de 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 | vswriter.h (incluye Vss.h, VsWriter.h) |
| Library | VssApi.lib |