Definindo opções de restauração do VSS
As opções de restauração permitem que os solicitantes comuniquem opções de restauração personalizadas aos gravadores.
Opções de restauração
Padronizar o formato das opções de restauração permite que gravadores e solicitantes manipulem solicitações personalizadas comuns. As opções de restauração são definidas pelo solicitante chamando o método IVssBackupComponents::SetRestoreOptions até uma vez por componente selected-for-backup antes de chamar o método IVssBackupComponents::P reRestore . A cadeia de caracteres passada no parâmetro wszRestoreOptions para o método SetRestoreOptions pode conter vários valores, conforme descrito abaixo.
Formatar
O formato das opções de restauração é um ou mais pares nome/valor separados por vírgulas e o nome é opcionalmente prefixado com o nome do subcomponente ao qual ele se aplica. Os nomes de componente e os nomes de opção não diferenciam maiúsculas de minúsculas. A diferenciação de maiúsculas e minúsculas dos valores é determinada pelo gravador. Por exemplo:
"Child1":"Option1"="Value1","Option2"="Value2","Child2\Grandchild3":"Option3"="Value3"
Neste exemplo, "Option1" aplica-se somente ao subcomponente "Child1" e seus descendentes, "Option2" aplica-se a todos os componentes e seus descendentes, e "Option3" aplica-se somente aos subcomponentes "Child2\Grandchild3" e seus descendentes.
O método SetRestoreOptions só pode ser chamado em componentes selecionáveis para backup, enquanto nós descendentes podem não ser selecionáveis para backup, eles podem ser selecionáveis para restauração.
Opções comuns de restauração
Essas opções comuns de restauração foram definidas para aumentar a interoperabilidade entre gravadores e solicitantes.
Autoritativa
A opção "Autoritative" dá suporte a vários valores de "Item", mas apenas um valor "All".
Todo esse componente é autoritativo.
"Authoritative"="All"
Somente o item especificado é autoritativo. O formato do item nomeado é definido pelo gravador. Designações comuns são "*" para indicar todos os arquivos, "..." para indicar todos os arquivos e subdiretórios do componente especificado.
"Authoritative"="Item:XXX"
Roll Forward
Depois que um banco de dados é restaurado, os gravadores geralmente são encaminhados por meio de logs para atualizar o banco de dados. No caso de restaurações incrementais ou diferenciais, o solicitante usa o método IVssBackupComponents::SetAdditionalRestores para controlar parcialmente o comportamento de tratamento de logs – essa opção de restauração permite um controle mais granular.
Não roll through logs.
"Roll Forward"="None"
Percorrer todos os logs.
"Roll Forward"="All"
Roll through logs up to specified point. O formato do ponto especificado é definido pelo gravador.
"Roll Forward"="Partial:XXX"
Novo nome do componente
Um gravador pode querer restaurar um componente para um novo nome. Por exemplo, restaurar um banco de dados para um nome diferente para restaurar um item individual; restaurar para o mesmo nome agradaria a todos os dados Recomendamos que os gravadores aceitem um caminho lógico válido e o nome do componente como o valor dessas opções. Isso geralmente será usado com um destino direcionado.
"New Component Name"="Logical Path\Component Name"