Compartilhar via


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

O método GetPreviousBackupStamp retorna um carimbo de backup anterior carregado por um solicitante no Documento de Componentes de Backup. O valor é usado por um gravador ao decidir se os arquivos devem participar da operação de backup diferencial ou incremental.

Um gravador ou um solicitante pode chamar esse método.

Sintaxe

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parâmetros

[out] pbstrBackupStamp

Ponteiro para uma cadeia de caracteres que contém o carimbo de data/hora de um backup anterior para que um backup diferencial ou incremental possa ser implementado corretamente.

Retornar valor

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

Valor Significado
S_OK
Retornou com êxito o valor do atributo.
S_FALSE
Nenhum carimbo de data/hora de backup anterior foi definido.
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_INVALID_XML_DOCUMENT
O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.

Comentários

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

O chamador deve liberar a memória mantida pelo parâmetro pbstrBackupStamp chamando SysFreeString.

Se não houver um carimbo de data/hora de backup anterior, GetPreviousBackupStamp retornará S_FALSE.

A cadeia de caracteres retornada refere-se a todos os arquivos no componente e a quaisquer subcomponentes não reelecionáveis que ela tenha.

O carimbo de backup recuperado por GetPreviousBackupStamp é definido por um solicitante usando IVssBackupComponents::SetPreviousBackupStamp.

Normalmente, a cadeia de caracteres usada para definir o valor encontrado por GetPreviousBackupStamp foi recuperada de um Documento de Componentes de Backup armazenado ou armazenada pelo solicitante como parte de seus próprios registros internos.

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent