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

  • Artigo

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 .

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