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

Artigo
08/27/2023

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