Método IVssBackupComponentsEx::GetWriterMetadataEx (vsbackup.h)

O método GetWriterMetadataEx retorna os metadados de uma instância de gravador específica em execução no sistema.

Sintaxe

HRESULT GetWriterMetadataEx(
  [in]  UINT                        iWriter,
  [out] VSS_ID                      *pidInstance,
  [out] IVssExamineWriterMetadataEx **ppMetadata
);

Parâmetros

[in] iWriter

Índice do gravador cujos metadados devem ser recuperados. O valor desse parâmetro é um inteiro de 0 a n-1 inclusive, em que n é o número total de gravadores no sistema atual. O valor de n é retornado pelo método IVssBackupComponents::GetWriterMetadataCount .

[out] pidInstance

Endereço de uma variável alocada pelo chamador que recebe o identificador de instância do gravador que coletou os metadados.

[out] ppMetadata

Ponteiro indireto doubly para a instância do objeto IVssExamineWriterMetadataEx que contém os metadados retornados.

Retornar valor

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

Valor	Significado
S_OK	Retornou com êxito um ponteiro para um objeto de interface IVssExamineWriterMetadataEx .
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_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 em VSS.
VSS_E_OBJECT_NOT_FOUND	O parâmetro iWriter não aponta para um gravador válido.
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

GetWriterMetadataEx é idêntico ao método IVssBackupComponents::GetWriterMetadata , exceto que ele retorna um ponteiro de interface IVssExamineWriterMetadataEx em vez de um ponteiro de interface IVssExamineWriterMetadata no parâmetro ppMetadata .

Um solicitante deve chamar o método assíncrono IVssBackupComponents::GatherWriterMetadata e aguardar sua conclusão antes de chamar GetWriterMetadataEx.

Embora o método GatherWriterMetadata precise ser chamado antes de uma operação de restauração ou backup, GetWriterMetadataEx normalmente não é chamado para restaurações.

As informações de componente recuperadas (durante operações de backup) usando o método IVssExamineWriterMetadata::GetComponent , em que a interface IVssExamineWriterMetadataEx foi retornada por GetWriterMetadataEx, vem do Documento de Metadados do Gravador de um processo de gravador ao vivo.

Isso contrasta com as informações retornadas por GetWriterComponents (durante operações de restauração), que foram armazenadas no Documento de Componentes de Backup por chamadas para o método IVssBackupComponents::AddComponent .

Quando o chamador desse método terminar de acessar os metadados, ele deverá chamar IUnknown::Release.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP1 [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::GetWriterMetadata

IVssBackupComponentsEx

IVssExamineWriterMetadata

IVssExamineWriterMetadataEx