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