Método IVssComponent::SetBackupStamp (vswriter.h)
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 |
|---|---|
|
Defina com êxito o carimbo de data/hora do backup. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 |