SisCreateBackupStructure 函式
SisCreateBackupStructure函式會根據提供的資訊建立 SIS 備份結構。
語法
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
參數
-
volumeRoot [in]
-
要備份之磁片區根目錄的檔案名，不含尾端反斜線。 例如，指定 「C：」 而非 「C：\」。
-
sisBackupStructure [out]
-
傳回的 SIS 備份結構。
-
commonStoreRootPathname [out]
-
指定磁片區通用存放區的完整路徑名稱。 例如，「c：\SIS Common Store」。
-
countOfCommonStoreFilesToBackUp [out]
-
commonStoreFilesToBackUp參數中列出的檔案數目。
-
commonStoreFilesToBackUp [out]
-
檔案名陣列的指標，指定 SIS 用來管理指定磁片區的內部檔案清單。 這些檔案應該同時備份，且與SisCSFilesToBackupForLink所要求的一般存放區檔案相同
傳回值
如果函式順利完成，則此函式會傳回 TRUE ，否則傳回 FALSE 。 呼叫 GetLastError 以取得呼叫失敗原因的詳細資訊。
備註
此函式會建立 SIS 備份結構，SIS 備份 API 會使用此結構來建立和維護磁片區上的檔案連結清單，以及連結所指向的原始檔案。 針對每個已啟用 SIS 的磁片區進行備份，應該只呼叫此函式一次。 指定磁片區內的所有檔案都應該視為一般存放區檔案，而且只有在 SIS 指出應該備份時才備份。
countOfCommonStoreFilesToBackUp和commonStoreFilesToBackUp參數會一起傳回必須備份的檔案清單，而不論備份的連結為何。
如果 countOfCommonStoreFilesToBackUp 為 0， commonStoreFilesToBackUp 可能是 Null 指標。 應該忽略 commonStoreFilesToBackUp參數的值。
備份作業完成之後，呼叫SisFreeAllocatedMemory來解除配置commonStoreFilesToBackUp字串陣列所使用的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|