共用方式為

VSS_RESTORE_TARGET列舉 (vswriter.h)

  • 發行項

寫入器會在還原時使用 VSS_RESTORE_TARGET 列舉，以指出所選取元件中包含的所有檔案，以及所定義之任何元件中的所有檔案，都會還原。 (如需選取元件的相關信息，請參閱 使用可選取性和邏輯路徑 。)

設定還原目標會修改或覆寫備份期間設定的還原方法， (請參閱 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
} ;

常數

 
VSS_RT_UNDEFINED
值： 0
未定義任何目標。


這個值表示寫入器部分的錯誤。

Express 寫入器不支持這個值。
VSS_RT_ORIGINAL
這是預設還原目標。


這個值表示還原包含在所選元件中的檔案 (或元件集
由該元件所定義，) 應該根據備份時間指定的原始還原方法繼續進行
VSS_RESTOREMETHOD_ENUM值。
VSS_RT_ALTERNATE
這些檔案會還原至從現有替代位置對應所決定的位置。


只有在替代位置時，還原目標才應設定為VSS_RT_ALTERNATE
已針對所選元件或元件集所管理的所有檔案設定對應。

Express 寫入器不支持這個值。
VSS_RT_DIRECTED
在還原時，使用寫入器導向的目標來還原檔案。


導向目標可讓寫入器依檔案控制檔案的方式
restored— 表示要還原多少檔案，以及要還原到哪些檔案中
要還原備份的檔案。

Express 寫入器不支持這個值。
VSS_RT_ORIGINAL_LOCATION
檔案會還原到備份時的位置，即使原始檔案也是一樣
在備份時間指定的 restore 方法為
VSS_RME_RESTORE_TO_ALTERNATE_LOCATION。


Windows Server 2003 和 Windows XP： 不支援這個值。

Express 寫入器不支持這個值。

備註

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 還原目標會構成寫入器錯誤，而要求者應該回報它。

如需詳細資訊，請參閱 非預設備份和還原位置 。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 vswriter.h

另請參閱

IVssComponent：：GetRestoreTarget

IVssComponent：：SetRestoreTarget

VSS_RESTOREMETHOD_ENUM