Compartilhar via

Método IVssExamineWriterMetadata::GetAlternateLocationMapping (vsbackup.h)

  • Artigo

O método GetAlternateLocationMapping obtém um mapeamento de local alternativo específico de um conjunto de arquivos.

Sintaxe

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

Parâmetros

[in] iMapping

Índice de um mapeamento específico. O valor desse parâmetro é um inteiro de 0 a n–1 inclusive, em que n é o número total de mapeamentos de localização alternativos associados a um determinado gravador. O valor de n é retornado por IVssExamineWriterMetadata::GetRestoreMethod.

[out] ppFiledesc

Ponteiro indireto duplamente para um objeto IVssWMFiledesc que contém as informações alternativas de mapeamento de localização.

Valor retornado

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

Valor Significado
S_OK
 Retornou com êxito um ponteiro para uma interface IVssWMFiledesc .
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_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_OBJECT_NOT_FOUND
 O mapeamento de local alternativo especificado não existe.
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

O valor retornado por IVssExamineWriterMetadata::GetAlternateLocationMapping não deve ser confundido com o retornado por IVssComponent::GetAlternateLocationMapping.

IVssComponent::GetAlternateLocationMapping é o local alternativo para o qual um arquivo foi restaurado.

IVssExamineWriterMetadata::GetAlternateLocationMapping é o mapeamento de localização alternativo para o qual um arquivo pode ser restaurado, se necessário.

Um arquivo sempre deverá ser restaurado para seu mapeamento de localização alternativo se qualquer um dos seguintes itens for verdadeiro:

  • O método de restauração (definido no momento do backup) é VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
  • Seu destino de restauração foi definido (no momento da restauração) como VSS_RT_ALTERNATE.
Em ambos os casos, se nenhum mapeamento de local alternativo válido for definido, isso constitui um erro de gravador.

Um arquivo poderá ser restaurado para um mapeamento de local alternativo se qualquer um dos seguintes itens for verdadeiro:

  • O método de restauração é VSS_RME_RESTORE_IF_NOT_THERE e uma versão do arquivo já está presente no disco.
  • O método de restauração é VSS_RME_RESTORE_IF_CAN_REPLACE e uma versão do arquivo está presente no disco e não pode ser substituída.
Novamente, se nenhum mapeamento de local alternativo válido for definido, isso constitui um erro de gravador.

Um mapeamento de local alternativo é usado somente durante uma operação de restauração e não deve ser confundido com um caminho alternativo, que é usado somente durante uma operação de backup.

O chamador é responsável por chamar IUnknown::Release para liberar os recursos do objeto IVssWMFiledesc retornado.

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::AddAlternativeLocationMapping

IVssComponent::GetAlternateLocationMapping

IVssExamineWriterMetadata

IVssExamineWriterMetadata::GetRestoreMethod

IVssWMFiledesc