SisCreateRestoreStructure 函式
SisCreateRestoreStructure函式會根據提供的資訊建立 SIS 還原結構。
語法
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
參數
-
volumeRoot [in]
-
要備份之磁片區根目錄的檔案名，不含尾端反斜線。 例如，指定 「C：」 而非 「C：\」。 磁片區不能是系統或開機磁片區。
-
sisRestoreStructure [out]
-
傳回的 SIS 還原結構。 呼叫端應該將此結構視為不透明。
-
commonStoreRootPathname [out]
-
指定磁片區通用存放區的完整路徑名稱。 例如，「c：\SIS Common Store」。
-
countOfCommonStoreFilesToRestore [out]
-
commonStoreFilesToRestore參數中列出的檔案數目。
-
commonStoreFilesToRestore [out]
-
檔案名陣列的指標，指定 SIS 用來管理指定磁片區的內部檔案清單。 這些檔案應該同時還原，且與 SisCSFilesToBackupForLink所要求的一般存放區檔案相同。
傳回值
如果函式順利完成，則此函式會傳回 TRUE ，否則傳回 FALSE 。 呼叫 GetLastError 以取得呼叫失敗原因的詳細資訊。
備註
此函式會以 SisCreateBackupStructure 在指定磁片區上建立備份環境的方式，在指定的磁片區上建立還原環境。
請注意，如果這些通用存放區檔案或檔案仍然存在於磁片上，此函式不一定會識別對應至備份媒體上一組 SIS 連結的通用存放區檔案或檔案。 一旦建立通用存放區檔案的資料流程內容永遠不會變更，因此如果檔案已存在於磁片上，就不需要還原它。
通用存放區檔案名是全域唯一的，以確保還原作業的完整性，即使它未發生在備份作業存取的相同已啟用 SIS 的磁片區上也一樣。
還原作業完成之後，藉由呼叫SisFreeAllocatedMemory來解除配置commonStoreFilesToRestore字串陣列所使用的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|