Compartilhar via

Função CreateVssExamineWriterMetadata (vsbackup.h)

  • Artigo

A função CreateVssExamineWriterMetadata cria um objeto IVssExamineWriterMetadata .

Nota Essa função é exportada como CreateVssExamineWriterMetadataInternal, mas você deve chamar CreateVssExamineWriterMetadata, não CreateVssExamineWriterMetadataInternal.

 

Sintaxe

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Parâmetros

[in] bstrXML

Uma cadeia de caracteres XML que contém um Documento de Metadados do Gravador com o qual inicializar o objeto IVssExamineWriterMetadata retornado.

[out] ppMetadata

Uma variável que recebe um ponteiro de interface IVssExamineWriterMetadata para o objeto .

Valor retornado

Os valores retornados listados aqui são além dos HRESULTs COM normais que podem ser retornados a qualquer momento da função.

Valor Significado
S_OK
 Retornou com êxito um ponteiro para uma interface IVssExamineWriterMetadata .
E_ACCESSDENIED
 O chamador não tem privilégios de backup suficientes ou não é um administrador.
E_INVALIDARG
 Um dos parâmetros não é válido.
E_OUTOFMEMORY
 Sem memória ou outros recursos do sistema.
VSS_E_INVALID_XML_DOCUMENT
 O documento XML passado no parâmetro bstrXML não é válido, ou seja, não é uma cadeia de caracteres XML formada corretamente ou não corresponde ao esquema.
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 em 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

Para salvar uma cópia do Documento de Metadados do Gravador de um gravador em uma cadeia de caracteres XML para passar o parâmetro bstrXML , use o método IVssExamineWriterMetadata::SaveAsXML .

Para recuperar a versão mais recente do Documento de Metadados do Gravador de um gravador, use o método IVssBackupComponents::GetWriterMetadata .

Para carregar um documento de metadados do gravador em um objeto IVssExamineWriterMetadata existente, use o método IVssExamineWriterMetadata::LoadFromXML .

Os usuários não devem tentar modificar o conteúdo do Documento de Metadados do Gravador.

O aplicativo de chamada é responsável por chamar IUnknown::Release para liberar os recursos mantidos pelo objeto IVssExamineWriterMetadata quando o objeto não for mais necessário.

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
DLL VssApi.dll

Confira também

IVssExamineWriterMetadata