Método IVssComponent::GetBackupStamp (vswriter.h)

  • Artículo

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
S_OK
 Devolvió correctamente el valor del atributo.
S_FALSE
 No hay ninguna marca de tiempo asociada a este componente.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
 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

Consulte también

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp