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

  • Artigo

O método GetBackupStamp retorna a cadeia de caracteres de carimbo de backup armazenada por um gravador para um determinado componente.

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

Sintaxe

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parâmetros

[out] pbstrBackupStamp

O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o carimbo de backup que indica a hora em que o componente foi copiado em backup.

Valor retornado

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
 Não há nenhum carimbo de data/hora associado a este componente.
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

Se nenhum carimbo de data/hora de backup tiver sido definido, GetBackupStamp retornará S_FALSE.

Se a chamada para GetBackupStamp for bem-sucedida, o chamador será responsável por liberar a cadeia de caracteres retornada no parâmetro pbstrBackupStamp chamando a função SysFreeString .

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 GetBackupStamp geralmente é definido por um gravador por uma chamada para IVssComponent::SetBackupStamp de dentro do manipulador de eventos PostSnapshot , CVssWriter::OnPostSnapshot.

Os solicitantes simplesmente armazenam os selos de backup no Documento de Componentes de Backup; eles não fazem uso direto do carimbo de backup, sabem como gerá-lo ou entendem seu formato.

Requisitos

   
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

IVssComponent::SetBackupStamp