Compartilhar via

Método IVssBackupComponents::SetPreviousBackupStamp (vsbackup.h)

  • Artigo

O método SetPreviousBackupStamp define o carimbo de backup de uma operação de backup anterior, na qual uma operação de backup diferencial ou incremental será baseada.

O método só pode ser chamado durante uma operação de backup.

Sintaxe

HRESULT SetPreviousBackupStamp(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszPreviousBackupStamp
);

Parâmetros

[in] writerId

Identificador do gravador.

[in] ct

Tipo do componente. Consulte VSS_COMPONENT_TYPE para obter os valores possíveis.

[in] wszLogicalPath

Cadeia de caracteres largos terminada em nulo que contém o caminho lógico do componente.

Para obter mais informações, consulte Caminhos lógicos de componentes.

O valor da cadeia de caracteres que contém o caminho lógico usado aqui deve ser o mesmo usado quando o componente foi adicionado ao conjunto de backup usando IVssBackupComponents::AddComponent.

O caminho lógico pode ser NULL.

[in] wszComponentName

Cadeia de caracteres largos terminada em nulo que contém o nome do componente.

A cadeia de caracteres não pode ser NULL e deve conter o mesmo nome de componente que foi usado quando o componente foi adicionado ao conjunto de backup usando IVssBackupComponents::AddComponent.

[in] wszPreviousBackupStamp

O carimbo de backup a ser definido.

Valor retornado

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 de backup anterior.
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
 O objeto de componentes de backup não é inicializado, esse método foi chamado durante uma operação de restauração ou esse método não foi chamado dentro da sequência correta.
VSS_E_OBJECT_NOT_FOUND
 O componente de backup não existe.
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.
VSS_E_UNEXPECTED
 Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros no VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

Esse método deve ser chamado antes de IVssBackupComponents::P repareForBackup.

Somente os solicitantes podem chamar esse método.

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

Os solicitantes simplesmente armazenam os carimbos de backup no Documento de Componentes de Backup. Eles não podem fazer uso direto dos selos de backup, não sabem seu formato e não sabem como gerá-los.

Portanto, o valor definido com SetPreviousBackupStamp deve ser recuperado do Documento de Componentes de Backup armazenado de uma operação de backup anterior (usando IVssComponent::GetBackupStamp para o componente correto) ou de informações armazenadas pelo solicitante em seus próprios registros internos.

Em seguida, um gravador obterá esse valor (usando IVssComponent::GetPreviousBackupStamp) e usá-lo poderá marcar os arquivos apropriados para participação em um backup incremental ou diferencial.

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 vsbackup.h (inclua VsBackup.h, Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssBackupComponents

IVssBackupComponents::P reRestore