Método IVssComponent::GetBackupStamp (vswriter.h)
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 |
|---|---|
|
Retornou com êxito o valor do atributo. |
|
Não há nenhum carimbo de data/hora associado a este componente. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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 |