共用方式為


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 之前,必須先選取 wszLogicalPathwszComponentName 參數所定義的根元件,才能使用 IVssBackupComponents::SetSelectedForRestore 進行還原。

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

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

若要參與這類還原,子元件必須將 bSelectableForRestore 成員設定為 TRUEVSS_COMPONENTINFOwszLogicalPathwszComponentName 參數所定義的元件也必須選取以使用 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