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 |
|