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 指示这些文件应备份。

countOfCommonStoreFilesToBackUpcommonStoreFilesToBackUp 参数一起返回一个文件列表,无论备份了哪些链接,都必须备份这些文件。

如果 countOfCommonStoreFilesToBackUp 为 0, 则 commonStoreFilesToBackUp 可能是 NULL 指针。 应忽略 commonStoreFilesToBackUp 参数的值。

备份操作完成后,通过调用 SisFreeAllocatedMemory 解除分配 commonStoreFilesToBackUp 字符串数组使用的内存。

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Sisbkup.h

Sisbkup.lib
DLL
Sisbkup.dll

另请参阅

SisCreateRestoreStructure

SisCSFilesToBackupForLink

SisFreeAllocatedMemory