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

  • Artículo

El método GetPreviousBackupStamp devuelve una marca de copia de seguridad anterior cargada por un solicitante en el documento componentes de copia de seguridad. El escritor usa el valor al decidir si los archivos deben participar en la operación diferencial o incremental de copia de seguridad.

Un escritor o un solicitante pueden llamar a este método.

Sintaxis

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parámetros

[out] pbstrBackupStamp

Puntero a una cadena que contiene la marca de tiempo de una copia de seguridad anterior para que se pueda implementar correctamente una copia de seguridad diferencial o incremental.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 Se devolvió correctamente el valor del atributo.
S_FALSE
 No se ha establecido ninguna marca de tiempo de copia de seguridad anterior.
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, vea Control de eventos y errores en VSS.

Comentarios

Para obtener más información sobre las marcas de copia de seguridad, vea Rol de escritor en la copia de seguridad de almacenes complejos y rol de solicitante en la copia de seguridad de almacenes complejos.

El autor de la llamada debe liberar la memoria que mantiene el parámetro pbstrBackupStamp mediante una llamada a SysFreeString.

Si no hay ninguna marca de tiempo de copia de seguridad anterior, GetPreviousBackupStamp devuelve S_FALSE.

La cadena devuelta hace referencia a todos los archivos del componente y a los subcomponentes no seleccionables que tiene.

La marca de copia de seguridad recuperada por GetPreviousBackupStamp se establece mediante un solicitante mediante IVssBackupComponents::SetPreviousBackupStamp.

Normalmente, la cadena utilizada para establecer el valor encontrado por GetPreviousBackupStamp se recuperó de un documento de componentes de copia de seguridad almacenado o lo almacenó el solicitante como parte de sus propios registros internos.

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

Consulte también

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent