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

O método AddDirectedTarget permite que um gravador indique no momento da restauração que, quando um arquivo deve ser restaurado, ele (o arquivo de origem) deve ser remapeado. O arquivo pode ser restaurado para um novo local de restauração e/ou intervalos de seus dados restaurados para diferentes deslocamentos dentro do local de restauração.

Esse método só pode ser chamado por um gravador durante uma operação de restauração.

Esse método não pode ser chamado durante o tratamento de um evento BackupComplete (CVssWriter::OnBackupComplete) ou BackupShutdown (CVssWriter::OnBackupShutdown).

Sintaxe

HRESULT AddDirectedTarget(
  [in] LPCWSTR wszSourcePath,
  [in] LPCWSTR wszSourceFilename,
  [in] LPCWSTR wszSourceRangeList,
  [in] LPCWSTR wszDestinationPath,
  [in] LPCWSTR wszDestinationFilename,
  [in] LPCWSTR wszDestinationRangeList
);

Parâmetros

[in] wszSourcePath

Cadeia de caracteres largos terminada em nulo que contém o caminho para o diretório no momento da restauração que contém o arquivo a ser restaurado (o arquivo de origem). Esse caminho deve corresponder ou estar abaixo do caminho de um conjunto de arquivos já no componente (ou um de seus subcomponentes se o componente definir um conjunto de componentes).

[in] wszSourceFilename

Cadeia de caracteres largos terminada em nulo que contém o nome do arquivo (no momento do backup) que será remapeado no momento da restauração (o arquivo de origem). O nome do arquivo (wszSourceFilename) não pode conter caracteres curinga (* ou ?) e deve ser consistente com a especificação de arquivo de um conjunto de arquivos que contém o caminho de origem (wszSourcePath).

[in] wszSourceRangeList

Uma cadeia de caracteres largos terminada em nulo que contém uma lista separada por vírgulas de deslocamentos e comprimentos de arquivo que indicam o intervalo de suporte do arquivo de origem (as seções do arquivo a serem realmente restauradas).

O número e o comprimento dos intervalos de suporte do arquivo de origem devem corresponder ao número e ao tamanho dos intervalos de suporte do arquivo de destino.

[in] wszDestinationPath

Cadeia de caracteres largos terminada em nulo que contém o caminho para o qual os dados do arquivo de origem serão remapeados no momento da restauração.

[in] wszDestinationFilename

Cadeia de caracteres largos terminada em nulo que contém o nome do arquivo para o qual os dados do arquivo de origem serão remapeados no momento da restauração. O nome do arquivo (wszDestinationFilename) não pode conter caracteres curinga (* ou ?).

[in] wszDestinationRangeList

Uma cadeia de caracteres largos terminada em nulo que contém uma lista separada por vírgulas de deslocamentos e comprimentos de arquivo que indicam o intervalo de suporte do arquivo de destino (locais para os quais as seções do arquivo de origem devem ser restauradas).

O número e o comprimento dos intervalos de suporte do arquivo de destino devem corresponder ao número e ao tamanho dos intervalos de suporte do arquivo de origem.

Retornar valor

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

Valor	Significado
S_OK	Defina o item com êxito.
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_BAD_STATE	Esse método não foi chamado por um gravador ou, se chamado por um gravador, ele não foi chamado durante uma operação de restauração ou foi chamado durante o tratamento de um evento BackupComplete ou BackupShutdown .

Comentários

Somente um gravador pode chamar AddDirectedTarget e somente durante operações de restauração.

Um solicitante usará as informações de destino direcionadas armazenadas no Documento de Componentes de Backup somente se o destino de restauração for VSS_RT_DIRECTED.

O método AddDirectedTarget pode ser aplicado a qualquer arquivo gerenciado no componente atual ou, se o componente definir um conjunto de componentes, em qualquer um de seus subcomponentes não selecionáveis.

As especificações de arquivo de origem e de destino podem apontar para o mesmo arquivo. Isso permitiria o remapeamento de um arquivo em si mesmo no momento da restauração.

A sintaxe da listagem de intervalo (wszSourceRanges e wszDestinationRanges) é a de uma lista separada por vírgulas do formulário offset1:length1, offset2:length2, em que cada deslocamento e comprimento é um inteiro de 64 bits especificando um deslocamento de bytes e comprimento em bytes, respectivamente. O deslocamento e o comprimento podem ser expressos como valores hexadecimais ou decimais.

O número de entradas e seus tamanhos devem corresponder nos argumentos de intervalo de origem e destino.

AddDirectedTarget pode usar como arquivo de origem qualquer arquivo já gerenciado pelo componente ou um de seus subcomponentes se o componente definir um conjunto de componentes.

Arquivos parciais poderão ser adicionados como destinos direcionados, se os intervalos de arquivos parciais a serem copiados corresponderem aos intervalos de origem de destino direcionados (consulte IVssComponent::AddPartialFile). Isso permitirá que você remapee arquivos parciais no momento da restauração.

Nesse caso, o solicitante recupera as informações de destino direcionadas chamando o método IVssComponent::GetDirectedTarget e usa isso para implementar o remapeamento dos dados de backup durante a restauração.

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

IVssComponent::GetDirectedTargetCount