VSS_RESTORE_TARGET enumeração (vswriter.h)

A enumeração VSS_RESTORE_TARGET é usada por um gravador no momento da restauração para indicar como todos os arquivos incluídos em um componente selecionado e todos os arquivos em qualquer conjunto de componentes definidos por ele devem ser restaurados. (Consulte Trabalhando com selebilidade e caminhos lógicos para obter informações sobre como selecionar componentes.)

Definir um destino de restauração modifica ou substitui o método de restauração definido durante o backup (consulte VSS_RESTOREMETHOD_ENUM).

Syntax

typedef enum VSS_RESTORE_TARGET {
  VSS_RT_UNDEFINED = 0,
  VSS_RT_ORIGINAL,
  VSS_RT_ALTERNATE,
  VSS_RT_DIRECTED,
  VSS_RT_ORIGINAL_LOCATION
} ;

Constantes

VSS_RT_UNDEFINED Valor: 0 Nenhum destino é definido. Esse valor indica um erro por parte do gravador. Não há suporte para esse valor para gravadores expressos.
VSS_RT_ORIGINAL Esse é o destino de restauração padrão. Esse valor indica que a restauração dos arquivos incluídos em um componente selecionado (ou no conjunto de componentes) definido por esse componente) deve continuar de acordo com o método de restauração original especificado no momento do backup por um valor VSS_RESTOREMETHOD_ENUM .
VSS_RT_ALTERNATE Os arquivos são restaurados para um local determinado a partir de um mapeamento de local alternativo existente. O destino de restauração deve ser definido como VSS_RT_ALTERNATE somente quando o local alternativo mapeamentos foram definidos para todos os arquivos gerenciados por um componente ou conjunto de componentes selecionado. Não há suporte para esse valor para gravadores expressos.
VSS_RT_DIRECTED Use o direcionamento direcionado pelo gravador no momento da restauração para restaurar um arquivo. O direcionamento direcionado permite que um gravador controle, em uma base arquivo por arquivo, como um arquivo é restaurado — indicando quanto de um arquivo deve ser restaurado e em quais arquivos o o arquivo de backup deve ser restaurado. Não há suporte para esse valor para gravadores expressos.
VSS_RT_ORIGINAL_LOCATION Os arquivos são restaurados para o local em que estavam no momento do backup, mesmo que o original método restore que foi especificado no momento do backup foi VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Windows Server 2003 e Windows XP: Não há suporte para esse valor. Não há suporte para esse valor para gravadores expressos.

Comentários

Um destino de VSS_RT_UNDEFINED indica um estado de erro.

No momento do backup, os gravadores definem o comportamento de restauração padrão indicando um método de restauração (VSS_RESTOREMETHOD_ENUM) definido com IVssCreateWriterMetadata::SetRestoreMethod.

Se um gravador não definir explicitamente o destino de restauração de um componente e qualquer conjunto de componentes definido por ele, por padrão, ele será definido como VSS_RT_ORIGINAL.

No momento da restauração, um valor de VSS_RESTORE_TARGET diferente de VSS_RT_ORIGINAL substitui o valor do método de restauração especificado originalmente especificado por VSS_RESTOREMETHOD_ENUM e definido por IVssCreateWriterMetadata::SetRestoreMethod.

Somente gravadores (usando IVssComponent::SetRestoreTarget) podem definir um destino de restauração (VSS_RESTORE_TARGET) e alterar como os arquivos são restaurados substituindo o método de restauração).

Solicitantes e gravadores podem acessar o destino de restauração atual por meio de IVssComponent::GetRestoreTarget.

Um destino de restauração de VSS_RT_ORIGINAL não significa que os arquivos devem ser restaurados para seu local original, mas que o método de restauração especificado originalmente (VSS_RESTOREMETHOD_ENUM) deve ser respeitado. Por exemplo, se um gravador definir um método de restauração de VSS_RME_RESTORE_TO_ALTERNATE_LOCATION para um componente selecionado e o destino de restauração for VSS_RT_ORIGINAL, os arquivos deverão ser restaurados para o local alternativo definido pelo gravador.

(Neste exemplo, se um gravador não definiu mapeamentos de localização alternativos, será um erro de gravador e o solicitante deverá reportá-lo.)

Um destino de restauração de VSS_RT_ALTERNATE sem um mapeamento de local alternativo definido constitui um erro de gravador e o solicitante deve reportá-lo como tal.

Consulte Locais de backup e restauração não padrão para obter mais informações.

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]
Cabeçalho	vswriter.h

Confira também

IVssComponent::GetRestoreTarget

IVssComponent::SetRestoreTarget

VSS_RESTOREMETHOD_ENUM