Método IVssComponent::GetBackupStamp (vswriter.h)
El método GetBackupStamp devuelve la cadena de marca de copia de seguridad almacenada por un escritor para un componente determinado.
Un escritor o un solicitante pueden llamar a este método.
Sintaxis
HRESULT GetBackupStamp(
[out] BSTR *pbstrBackupStamp
);
Parámetros
[out] pbstrBackupStamp
Dirección de una variable asignada por el autor de la llamada que recibe una cadena que contiene la marca de copia de seguridad que indica la hora en la que se realizó la copia de seguridad del componente.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
Valor | Significado |
---|---|
|
Devolvió correctamente el valor del atributo. |
|
No hay ninguna marca de tiempo asociada 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, consulte Control de eventos y errores en VSS. |
Comentarios
Si no se ha establecido ninguna marca de tiempo de copia de seguridad, GetBackupStamp devuelve S_FALSE.
Si la llamada a GetBackupStamp es correcta, el autor de la llamada es responsable de liberar la cadena que se devuelve en el parámetro pbstrBackupStamp llamando a la función SysFreeString .
La cadena devuelta hace referencia a todos los archivos del componente y a los subcomponentes no seleccionables que tenga.
La marca de copia de seguridad recuperada por GetBackupStamp suele establecerse mediante un escritor mediante una llamada a IVssComponent::SetBackupStamp desde el controlador de eventos PostSnapshot , CVssWriter::OnPostSnapshot.
Los solicitantes simplemente almacenan los sellos de copia de seguridad en el documento componentes de copia de seguridad; no hacen uso directo de la marca de copia de seguridad, saben cómo generarla o comprender su formato.
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 (incluya Vss.h, VsWriter.h) |
Library | VssApi.lib |