Definição de métodos de restauração do VSS

A configuração das operações de restauração realmente começa durante o backup de dados, quando os gravadores especificam, em seus Documentos de Metadados de Gravador, como seus dados devem ser restaurados.

Observação

A API MoveFileEx não pode ser usada para restaurar arquivos do Registro.

Essas especificações, conhecidas como métodos de restauração ou destinos de restauração originais, podem ser modificadas durante a restauração por gravadores definindo novos destinos de restauração ou por solicitantes restaurando para novos locais (consulte Locais de backup e restauração não padrão).

Ao chamar IVssCreateWriterMetadata::SetRestoreMethod, um gravador indica qual método de restauração deve ser usado em seu Documento de Metadados do Gravador. O método de restauração é definido como gravador largo e aplicado a todos os arquivos em todos os componentes gerenciados por um gravador.

Um solicitante obtém (e deve respeitar) essas informações chamando IVssExamineWriterMetadata::GetRestoreMethod.

O método de restauração é definido por uma enumeração VSS_RESTOREMETHOD_ENUM , que é passada para IVssCreateWriterMetadata::SetRestoreMethod e retornada de IVssExamineWriterMetadata::GetRestoreMethod.

O Documento de Metadados do Gravador dá suporte aos seguintes métodos de restauração válidos (um método de restauração de VSS_RME_UNDEFINED indica um erro de gravador). Os números resumem como os vários métodos de restauração com suporte e definidos devem ser implementados (VSS_RME_CUSTOM não tem nenhuma figura associada a ele, pois, por definição, ele é específico do gravador e deve seguir as APIs e a documentação específicas do gravador):

• VSS_RME_RESTORE_IF_NOT_THERE. Restaure os arquivos de componente para o disco se nenhum dos arquivos já estiver no disco. O status do arquivo de destino deve ser verificado após um evento PreRestore .
• VSS_RME_RESTORE_IF_CAN_REPLACE. Restaure arquivos no disco se todos os arquivos puderem ser substituídos. O status do arquivo de destino deve ser verificado após um evento PreRestore .
• VSS_RME_STOP_RESTORE_START. Um serviço será interrompido antes de restaurar os arquivos.
• VSS_RME_RESTORE_TO_ALTERNATE_LOCATION. Restaurar arquivos em disco em um local alternativo. Os mapeamentos de localização alternativos são especificados no Documento de Metadados do Gravador.
• VSS_RME_RESTORE_AT_REBOOT. Faça com que os arquivos sejam restaurados (substituídos) quando o computador for reinicializado.
• VSS_RME_RESTORE_AT_REBOOT_IF_CANNOT_REPLACE. Se um arquivo não puder ser restaurado para o disco em um sistema em execução, ele será restaurado (substituído) quando o computador for reinicializado.
• VSS_RME_CUSTOM. Nenhum dos métodos predefinidos funcionará; o aplicativo de backup deve usar APIs especializadas para executar a operação de restauração. Para esse método de backup, o solicitante deve entender completamente o gravador em questão. Consulte Casos especiais de uso do VSS para instâncias com suporte no momento.