Método IVssWMFiledesc::GetAlternateLocation (vswriter.h)

O método GetAlternateLocation obtém um local alternativo para um conjunto de arquivos.

Sintaxe

HRESULT GetAlternateLocation(
  [out] BSTR *pbstrAlternateLocation
);

Parâmetros

[out] pbstrAlternateLocation

O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres especificando o local de backup alternativo. O caminho desse local pode ser um caminho local ou o caminho UNC de um compartilhamento de arquivos remoto. Se não houver um local alternativo, o ponteiro será NULL.

Valor retornado

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

Valor	Significado
S_OK	Retornou com êxito as informações de localização alternativas.
S_FALSE	Não foi possível encontrar as informações solicitadas.
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 em VSS.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Não há suporte para compartilhamentos de arquivos remotos até o Windows 8 e o Windows Server 2012.

O chamador deve chamar SysFreeString para liberar a memória mantida pelo parâmetro pbstrAlternateLocation .

A interpretação do local alternativo retornado por GetAlternateLocation difere dependendo do método usado para recuperar o objeto IVssWMFiledesc .

• IVssExamineWriterMetadata::GetExcludeFile
• IVssWMComponent::GetDatabaseFile
• IVssWMComponent::GetDatabaseLogFile
• IVssWMComponent::GetFile

O valor retornado por GetAlternateLocation refere-se a um mapeamento de localização alternativo quando retornado pelo método IVssExamineWriterMetadata::GetAlternateLocationMapping .

Durante as operações de backup, esse é o local alternativo do qual fazer backup de um arquivo. Durante uma restauração, é o local alternativo para o qual restaurar um arquivo.

Para obter mais informações, consulte Locais de backup e restauração não padrão.

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

IVssWMFiledesc