設定 VSS 還原選項

還原選項可讓要求者將自訂的還原選項傳達給撰寫者。

還原選項

標準化還原選項的格式可讓寫入器和要求者處理常見的自定義要求。 還原選項是由要求者設定，方法是在呼叫 IVssBackupComponents::PreRestore 方法之前，最多先為每個選擇進行備份的元件呼叫一次 IVssBackupComponents::SetRestoreOptions 方法。 傳入 wszRestoreOptions 參數至 SetRestoreOptions 方法的字串可以包含多個值，如下所述。

格式

還原選項的格式是一或多個逗號分隔的名稱/值組，而且名稱會選擇性地加上其所套用之子元件的名稱。 元件名稱和選項名稱不區分大小寫。 值的區分大小寫是由撰寫者決定。 例如：

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

在此範例中，“Option1” 僅適用於 “Child1” 子元件及其子系，“Option2” 適用於所有元件及其子系，而 “Option3” 僅適用於 “Child2\Grandchild3” 子元件及其子系。

SetRestoreOptions 方法只能在可選取進行備份的元件上呼叫，而子系節點可能無法選取進行備份，但可能可供選取以進行還原。

常見的還原選項

這些常見的還原選項已定義，以增加寫入端和請求端之間的互通性。

• 權威

  [權威性] 選項支援多個 "Item" 值，但只有一個 "All" 值。

  此整個元件具有權威性。

  "Authoritative"="All"
  

  只有指定的項目具有權威性。 所述項目的格式由作者定義。 常見的指定是 “*” 表示所有檔案 “...”表示指定元件的所有檔案和子目錄。

  "Authoritative"="Item:XXX"
  

• 向前推進

  還原資料庫之後，管理者通常會通過套用日誌來更新，以確保資料庫處於最新狀態。 在增量或差異還原的情況下，要求者會使用 IVssBackupComponents：：SetAdditionalRestores 方法來部分控制記錄處理行為 - 此還原選項允許更細微的控制。

  請勿翻閱日誌。

  "Roll Forward"="None"
  

  瀏覽所有記錄。

  "Roll Forward"="All"
  

  瀏覽記錄至指定點。 指定的點格式由撰寫者所定義。

  "Roll Forward"="Partial:XXX"
  

• 新增元件名稱

  作家可能會想要將元件更改至新名稱。 例如，將資料庫還原到不同的名稱以單獨還原某個專案；還原到相同名稱可維持所有數據的一致性。我們建議編寫者將有效的邏輯路徑和元件名稱作為此選項的值。 這通常會與 導向目標搭配使用。

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