IVssBackupComponents：：AddRestoreSubcomponent 方法 (vsbackup.h)

  • 發行項

AddRestoreSubcomponent 方法表示元件集的子元件成員已標示為無法選取備份，但標示為可還原，不論是否要還原元件集的任何其他成員，都會還原。

語法

HRESULT AddRestoreSubcomponent(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE componentType,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszSubComponentLogicalPath,
  [in] LPCWSTR            wszSubComponentName,
  [in] bool               bRepair
);

參數

[in] writerId

寫入器類別標識碼。

[in] componentType

識別元件的型別。 如需可能的傳回值 ，請參閱VSS_COMPONENT_TYPE 檔。

[in] wszLogicalPath

以 Null 終止的寬字元字串，其中包含備份檔中元件的邏輯路徑，該字串會定義包含要新增以進行還原之子元件的備份元件集。

此參數的值可以是 NULL。

在非 NULL 邏輯路徑中出現的字元沒有任何限制。

[in] wszComponentName

以 Null 終止的寬字元字串，其中包含備份檔中元件的邏輯路徑，該字串會定義包含要新增以進行還原之子元件的備份元件集。

此參數的值不可以是 NULL。

可以出現在非 NULL 元件名稱中的字元沒有任何限制。

[in] wszSubComponentLogicalPath

以 Null 結束的寬字元字串，其中包含要加入以進行還原之子元件的邏輯路徑。

新增子元件時，需要邏輯路徑。 因此，這個參數的值不能是 NULL。

在非 NULL 邏輯路徑中出現的字元沒有任何限制。

[in] wszSubComponentName

以 Null 結尾的寬字元字串，其中包含要新增以進行還原之子元件的邏輯名稱。

此參數的值不可以是 NULL。

可以出現在非 NULL 元件名稱中的字元沒有任何限制。

[in] bRepair

這個參數保留給未來使用。 此參數應一律設定為 false

傳回值

以下是這個方法的有效傳回碼。

值 意義
S_OK
 已成功新增還原子元件。
E_INVALIDARG
 其中一個參數值無效。
E_OUTOFMEMORY
 呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
 備份元件物件未初始化、在還原作業期間尚未呼叫此方法，或未在正確的順序內呼叫此方法。
VSS_E_INVALID_XML_DOCUMENT
 XML 檔無效。 請檢查事件記錄檔以取得詳細數據。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。
VSS_E_OBJECT_NOT_FOUND
 元件不存在。
VSS_E_UNEXPECTED
 非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支援此值。 E_UNEXPECTED改用。

備註

呼叫 AddRestoreSubcomponent 之前，必須先選取 wszLogicalPath 和 wszComponentName 參數所定義的根元件，才能使用 IVssBackupComponents：：SetSelectedForRestore 進行還原。

如果要求者支援還原子元件，則必須在 IVssBackupComponents：:P reRestore 之前呼叫此方法。

AddRestoreSubcomponent 適用於寫入器元件集中的所有檔案都必須備份為一個單位，但想要讓選取的檔案 (子元件) 能夠個別還原的情況。

若要參與這類還原，子元件必須將 bSelectableForRestore 成員設定為 TRUEVSS_COMPONENTINFO。 wszLogicalPath 和 wszComponentName 參數所定義的元件也必須選取以使用 IVssBackupComponents：：SetSelectedForRestore 進行還原。

如需詳細資訊，請參閱 使用還原和子元件的可選取性 。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssBackupComponents

IVssBackupComponents：:P reRestore

VSS_COMPONENT_TYPE