Share via

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

  • Artigo

O método SetBackupStamp define uma cadeia de caracteres contendo informações que indicam quando um backup ocorreu.

Um gravador só pode chamar esse método durante uma operação de backup.

Esse método não pode ser chamado durante o tratamento de um evento BackupComplete (CVssWriter::OnBackupComplete) ou BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaxe

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

Parâmetros

[in] wszBackupStamp

Informações de cadeia de caracteres largos terminadas em nulo indicando quando um backup ocorreu.

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
 Defina com êxito o carimbo de data/hora do backup.
E_INVALIDARG
 Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
 O chamador está sem memória ou outros recursos do sistema.
VSS_E_BAD_STATE
 Esse método não foi chamado por um gravador ou, se chamado por um gravador, ele não foi chamado durante uma operação de backup ou foi chamado durante o tratamento de um evento BackupComplete ou BackupShutdown.

Comentários

Para obter mais informações sobre selos de backup, consulte Função de gravador no backup de repositórios complexos.

O carimbo de backup definido por SetBackupStamp aplica-se a todos os arquivos no componente e a quaisquer subcomponentes não reelecionáveis que ele tenha.

Os gravadores normalmente chamam SetBackupStamp enquanto manipulam um evento PostSnapshot em CVssWriter::OnPostSnapshot.

Os solicitantes apenas armazenam o carimbo de backup no Documento de Componentes de Backup. Eles não fazem uso direto do selo de backup ou precisam saber como interpretá-lo.

O único uso do carimbo de backup que um solicitante faz, durante uma operação de restauração, é disponibilizar a cadeia de caracteres de carimbo de data/hora armazenada para um gravador usando o método IVssBackupComponents::SetPreviousBackupStamp .

Por esse motivo, não há restrições de formato no conteúdo do selo de backup. Ele pode conter informações de data e hora, números de sequência lógica ou qualquer outra informação que permita que um gravador da mesma classe determine quando o último backup ocorreu.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssComponent

IVssComponent::GetBackupStamp