Функция 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, которая используется API резервного копирования SIS для создания и поддержки списка ссылок на файлы в томе и исходных файлов, на которые указывают ссылки. Эта функция должна вызываться только один раз для каждого тома с поддержкой SIS, для которых выполняется резервное копирование. Все файлы в указанном томе должны рассматриваться как файлы общего хранилища и создавать резервные копии только в том случае, если служба SIS указывает, что это необходимо.
Параметры countOfCommonStoreFilesToBackUp и commonStoreFilesToBackUp вместе возвращают список файлов, для которых необходимо создать резервную копию независимо от того, какие ссылки архивируются.
Если аргумент countOfCommonStoreFilesToBackUp имеет значение 0, commonStoreFilesToBackUp может быть указателем NULL . Значение параметра commonStoreFilesToBackUp следует игнорировать.
После завершения операции резервного копирования освободите память, используемую массивом строк commonStoreFilesToBackUp , вызвав SisFreeAllocatedMemory.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|