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

El método SetBackupStamp establece una cadena que contiene información que indica cuándo se realizó una copia de seguridad.

Un escritor solo puede llamar a este método durante una operación de copia de seguridad.

No se puede llamar a este método mientras se controla un evento BackupComplete (CVssWriter::OnBackupComplete) o BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaxis

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

Parámetros

[in] wszBackupStamp

Información de cadena de caracteres anchos terminada en NULL que indica cuándo tuvo lugar una copia de seguridad.

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.
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
Un escritor no llamó a este método o, si lo llama un escritor, no se llamó durante una operación de copia de seguridad o se llamó al controlar un evento BackupComplete o BackupShutdown.

Comentarios

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

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

Los escritores suelen llamar a SetBackupStamp mientras se controla un evento PostSnapshot en CVssWriter::OnPostSnapshot.

Los solicitantes simplemente almacenan la marca de copia de seguridad en el documento componentes de copia de seguridad. No hacen uso directo del sello de copia de seguridad ni tienen que saber cómo interpretarlo.

El único uso de la marca de copia de seguridad que realiza un solicitante, durante una operación de restauración, es hacer que la cadena de marca de tiempo almacenada esté disponible para un escritor mediante el método IVssBackupComponents::SetPreviousBackupStamp .

Por este motivo, no hay restricciones de formato en el contenido de la marca de copia de seguridad. Puede contener información de fecha y hora, números de secuencia lógica o cualquier otra información que permita que un escritor de la misma clase determine cuándo se ha realizado la última copia de seguridad.

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

Consulte también

IVssComponent

IVssComponent::GetBackupStamp