VSS_RESTORE_TARGET 枚举 (vswriter.h)

项目
08/27/2023

编写器在还原时使用 VSS_RESTORE_TARGET 枚举来指示如何还原所选组件中包含的所有文件，以及它定义的任何组件集中的所有文件。 (有关选择组件的信息，请参阅使用可选择性和逻辑路径。)

设置还原目标会修改或替代备份期间设置的还原方法， (请参阅 VSS_RESTOREMETHOD_ENUM) 。

语法

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

常量


`VSS_RT_UNDEFINED` 值： 0 未定义目标。此值指示编写器部分出现错误。快速编写器不支持此值。
`VSS_RT_ORIGINAL` 这是默认还原目标。此值指示所选组件中包含的文件还原 (或组件集由该组件定义的) 应按照在备份时指定的原始还原方法继续 VSS_RESTOREMETHOD_ENUM值。
`VSS_RT_ALTERNATE` 文件将还原到根据现有备用位置映射确定的位置。还原目标应设置为仅当备用位置时VSS_RT_ALTERNATE 已为所选组件或组件集管理的所有文件设置了映射。快速编写器不支持此值。
`VSS_RT_DIRECTED` 在还原时使用编写器定向目标来还原文件。定向目标允许编写器逐个文件控制文件的方式 restored - 指示要还原的文件量以及要还原到哪些文件中将还原备份文件。快速编写器不支持此值。
`VSS_RT_ORIGINAL_LOCATION` 文件将还原到备份时所在的位置，即使原始文件备份时指定的还原方法为 VSS_RME_RESTORE_TO_ALTERNATE_LOCATION。 Windows Server 2003 和 Windows XP：不支持此值。快速编写器不支持此值。

注解

VSS_RT_UNDEFINED 的目标指示错误状态。

在备份时，编写器通过指示还原方法 (VSS_RESTOREMETHOD_ENUM 使用 IVssCreateWriterMetadata：：SetRestoreMethod 设置) 来设置默认还原行为。

如果编写器未显式设置组件的还原目标，并且它定义的任何组件集，则默认情况下，它设置为 VSS_RT_ORIGINAL。

在还原时，除 VSS_RT_ORIGINAL 以外的VSS_RESTORE_TARGET值将替代由 VSS_RESTOREMETHOD_ENUM 指定并由 IVssCreateWriterMetadata：：SetRestoreMethod 设置的最初指定还原方法的值。

只有使用 IVssComponent：：SetRestoreTarget) (编写器才能设置还原目标 (VSS_RESTORE_TARGET) ，并更改文件还原方式，替代还原方法) 。

请求者和编写者可以通过 IVssComponent：：GetRestoreTarget 访问当前还原目标。

还原目标VSS_RT_ORIGINAL并不意味着应将文件还原到其原始位置，但必须遵循最初指定的还原方法 (VSS_RESTOREMETHOD_ENUM) 。例如，如果编写器为所选组件设置了 VSS_RME_RESTORE_TO_ALTERNATE_LOCATION 还原方法，并且 还原目标VSS_RT_ORIGINAL，则应将文件还原到编写器定义的备用位置。

(在此示例中，如果编写器未能定义备用位置映射，则这是编写器错误，请求者应报告它。)

未定义备用位置映射的 VSS_RT_ALTERNATE 还原目标构成编写器错误，请求者应按此方式报告。

有关详细信息，请参阅非默认备份和还原位置。