设置 VSS 还原选项

还原选项允许请求者向编写者传达自定义的还原选项。

还原选项

标准化还原选项的格式允许编写者和请求者处理常见的自定义请求。 在调用 IVssBackupComponents：:P reRestore 方法之前，请求者通过为每个所选备份组件调用 IVssBackupComponents：：SetRestoreOptions 方法最多设置一次还原选项。 在 wszRestoreOptions 参数中传递给 SetRestoreOptions 方法的字符串可以包含多个值，如下所述。

格式

还原选项的格式是一个或多个逗号分隔的名称/值对，并且该名称（可选）以应用该名称的子组件的名称作为前缀。 组件名称和选项名称不区分大小写。 值的区分大小写由编写器确定。 例如：

"Child1":"Option1"="Value1","Option2"="Value2","Child2\Grandchild3":"Option3"="Value3"

在此示例中，“Option1”仅适用于“Child1”子组件及其后代，“Option2”适用于所有组件及其后代，“Option3”仅适用于“Child2\Grandchild3”子组件及其后代。

SetRestoreOptions 方法只能在可选择进行备份的组件上调用，而后代节点可能无法选择进行备份，但可以选择用于还原。

常见还原选项

已定义这些常见的还原选项，以提高编写者和请求者之间的互操作性。

• 权威

  “权威”选项支持多个“项”值，但仅支持一个“所有”值。

  此整个组件具有权威性。

  "Authoritative"="All"
  

  只有指定的项才具有权威性。 命名项的格式由编写器定义。 常见名称为“*”以指示所有文件，“...”指示指定组件的所有文件和子目录。

  "Authoritative"="Item:XXX"
  

• 前滚

  还原数据库后，编写器通常会前滚日志以使数据库处于最新状态。 对于增量还原或差异还原，请求者使用 IVssBackupComponents：：SetAdditionalRestores 方法部分控制日志处理行为 - 此还原选项允许更精细的控制。

  不要滚动浏览日志。

  "Roll Forward"="None"
  

  滚动浏览所有日志。

  "Roll Forward"="All"
  

  将日志向上滚动到指定点。 指定点的格式由编写器定义。

  "Roll Forward"="Partial:XXX"
  

• 新组件名称

  编写器可能想要将组件还原到新名称。 例如，将数据库还原到其他名称以还原单个项;还原到同一名称会让所有数据都满意 我们建议编写器接受有效的逻辑路径和组件名称作为此选项的值。 这通常与 定向目标一起使用。

  "New Component Name"="Logical Path\Component Name"