Compartilhar via


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

O método SetBackupMetadata define metadados de backup com o componente .

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 SetBackupMetadata(
  [in] LPCWSTR wszData
);

Parâmetros

[in] wszData

Uma cadeia de caracteres largos terminada em NULL que contém os metadados de backup.

Valor retornado

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

Valor Significado
S_OK
Defina o item com êxito.
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_OBJECT_ALREADY_EXISTS
Metadados privados já foram gravados para esse componente.
VSS_E_BAD_STATE
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

SetBackupMetadata define metadados privados e específicos do gravador que descrevem uma operação de backup.

O formato não precisa estar em conformidade com nenhuma especificação de metadados do VSS.

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

IVssComponent

IVssComponent::GetBackupMetadata

IVssComponent::SetRestoreMetadata