Método IVssComponent::GetDirectedTarget (vswriter.h)
O método GetDirectedTarget retorna informações armazenadas por um gravador, no momento do backup, para o Documento de Componentes de Backup para indicar que, quando um arquivo deve ser restaurado, ele (o arquivo de origem) deve ser remapeado. O arquivo pode ser restaurado para um novo destino de restauração e/ou intervalos de seus dados restaurados para locais diferentes com o destino de restauração.
Um gravador ou um solicitante pode chamar esse método.
Sintaxe
HRESULT GetDirectedTarget(
[in] UINT iDirectedTarget,
[out] BSTR *pbstrSourcePath,
[out] BSTR *pbstrSourceFileName,
[out] BSTR *pbstrSourceRangeList,
[out] BSTR *pbstrDestinationPath,
[out] BSTR *pbstrDestinationFilename,
[out] BSTR *pbstrDestinationRangeList
);
Parâmetros
[in] iDirectedTarget
Número de índice do destino direcionado. O valor desse parâmetro é um inteiro de 0 a n–1 inclusive, em que n é o número total de destinos direcionados associados a um determinado componente (e seus subcomponentes se ele definir um conjunto de componentes). O valor de n é retornado por IVssComponent::GetDirectedTargetCount.
[out] pbstrSourcePath
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o caminho para o diretório que, no momento do backup, continha o arquivo a ser restaurado (o arquivo de origem). Esse caminho deve corresponder ou estar abaixo do caminho de um conjunto de arquivos que já está no componente ou em um de seus subcomponentes (se o componente definir um conjunto de componentes).
[out] pbstrSourceFileName
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o nome do arquivo (no momento do backup) que deve ser remapeado durante uma restauração (o arquivo de origem). O nome desse arquivo não deve conter caracteres curinga e deve ser um membro do mesmo conjunto de arquivos que o caminho de origem (pbstrSourcePath).
[out] pbstrSourceRangeList
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém uma lista separada por vírgulas de deslocamentos de arquivo e comprimentos que indicam o intervalo de suporte do arquivo de origem (as seções do arquivo a ser restaurado).
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.
[out] pbstrDestinationPath
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o caminho para o qual os dados do arquivo de origem serão remapeados no momento da restauração.
[out] pbstrDestinationFilename
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém o nome do arquivo para o qual os dados do arquivo de origem serão remapeados no momento da restauração.
[out] pbstrDestinationRangeList
O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres que contém uma lista separada por vírgulas de deslocamentos de arquivo e comprimentos 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 |
|---|---|
|
Retornou com êxito o valor do atributo. |
|
Um dos valores de parâmetro não é válido. |
|
O chamador está sem memória ou outros recursos do sistema. |
|
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. |
|
O item especificado não foi encontrado. |
Comentários
Se a chamada para GetDirectedTarget for bem-sucedida, o chamador será responsável por liberar cada cadeia de caracteres retornada chamando a função SysFreeString .
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.
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.
Os arquivos cujos destinos direcionados são retornados por GetDirectedTarget podem ser membros dos arquivos do componente atual ou de qualquer subcomponente definido por ele.
O chamador deve liberar a memória mantida pelos parâmetros pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename e pbstrDestinationRangeList chamando SysFreeString.
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.
O solicitante precisará marcar se o arquivo de origem de destino direcionado tiver sido copiado como um arquivo parcial para implementar corretamente a restauração. Se esse for o caso, o solicitante usará as informações de destino direcionadas em conjunto com as informações parciais do arquivo (IVssComponent::GetPartialFile) 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 |