Método IVssBackupComponents::SetPreviousBackupStamp (vsbackup.h)

  • Artículo

El método SetPreviousBackupStamp establece la marca de copia de seguridad de una operación de copia de seguridad anterior, en la que se basará una operación de copia de seguridad diferencial o incremental.

Solo se puede llamar al método durante una operación de copia de seguridad.

Sintaxis

HRESULT SetPreviousBackupStamp(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszPreviousBackupStamp
);

Parámetros

[in] writerId

Identificador de escritor.

[in] ct

Tipo del componente. Consulte VSS_COMPONENT_TYPE para conocer los valores posibles.

[in] wszLogicalPath

Cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica del componente.

Para obtener más información, vea Ruta de acceso lógica de componentes.

El valor de la cadena que contiene la ruta de acceso lógica usada aquí debe ser el mismo que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

La ruta de acceso lógica puede ser NULL.

[in] wszComponentName

Cadena de caracteres anchos terminada en NULL que contiene el nombre del componente.

La cadena no puede ser NULL y debe contener el mismo nombre de componente que se usó cuando se agregó el componente al conjunto de copia de seguridad mediante IVssBackupComponents::AddComponent.

[in] wszPreviousBackupStamp

Marca de copia de seguridad que se va a establecer.

Valor devuelto

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

Valor Significado
S_OK
 Establezca correctamente la 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_BAD_STATE
 El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta.
VSS_E_OBJECT_NOT_FOUND
 El componente de copia de seguridad no existe.
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.
VSS_E_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

Se debe llamar a este método antes de IVssBackupComponents::P repareForBackup.

Solo los solicitantes pueden llamar a este método.

La marca de copia de seguridad establecida por SetPreviousBackupStamp se aplica a todos los archivos del componente y a todos los subcomponentes no seleccionables que tenga.

Los solicitantes simplemente almacenan los sellos de copia de seguridad en el documento Componentes de copia de seguridad. No pueden hacer uso directo de los stamps de copia de seguridad, no conocen su formato y no saben cómo generarlos.

Por lo tanto, el valor establecido con SetPreviousBackupStamp debe recuperarse del documento de componentes de copia de seguridad almacenados de una operación de copia de seguridad anterior (mediante IVssComponent::GetBackupStamp para el componente correcto) o de la información almacenada por el solicitante en sus propios registros internos.

A continuación, un escritor obtendrá este valor (mediante IVssComponent::GetPreviousBackupStamp) y su uso podrá marcar los archivos adecuados para la participación en una copia de seguridad incremental o diferencial.

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 vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssBackupComponents

IVssBackupComponents::P reRestore