Compartilhar via

Método IVssComponent::GetNewTarget (vswriter.h)

  • Artigo

O método GetNewTarget retorna os novos locais de restauração de arquivo para o componente ou conjunto de componentes selecionado. (Consulte Trabalhando com selebilidade e caminhos lógicos para obter informações sobre como selecionar componentes.)

Um gravador ou um solicitante pode chamar esse método.

Sintaxe

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

Parâmetros

[in] iNewTarget

Número de índice do novo destino. O valor desse parâmetro é um inteiro de 0 a n–1 inclusive, em que n é o número total de novos destinos associados a um determinado componente. O valor de n é retornado por IVssComponent::GetNewTargetCount.

[out] ppFiledesc

Ponteiro indireto duplamente para um objeto IVssWMFiledesc que contém as novas informações de local de restauração de destino.

Retornar valor

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

Valor Significado
S_OK
 Retornou com êxito o valor do atributo.
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 item especificado não foi encontrado.

Comentários

Novos destinos retornados por GetNewTarget podem ser aqueles não apenas de arquivos no componente atual, mas de arquivos em qualquer um de seus subcomponentes não selecionáveis.

Requisitos

Requisito Valor
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

IVssComponent

IVssComponent::GetNewTargetCount