Функция SisRestoredLink
Функция SisRestoredLink возвращает имена файлов общего хранилища или файлов, на которые указывает указанная восстановленная ссылка SIS.
Синтаксис
BOOL SisRestoredLink(
_In_ PVOID sisRestoreStructure,
_In_ PWCHAR restoredFileName,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Параметры
-
sisRestoreStructure [in]
-
Указатель на структуру восстановления SIS, возвращенную из SisCreateRestoreStructure.
-
restoredFileName [in]
-
Полное имя восстановленного файла ссылки SIS.
-
reparseData [in]
-
Указатель на содержимое точки повторного аналитики SIS. Эта точка повторного анализа содержит данные, описывающие восстановленную ссылку SIS. Чтобы получить данные точки повторного анализа для файла, используйте код элемента управления FSCTL_GET_REPARSE_POINT .
-
reparseDataSize [in]
-
Размер содержимого точки повторного аналитики SIS, на которую указывает reparseData, в байтах.
-
countOfCommonStoreFilesToRestore [out]
-
Количество файлов, перечисленных в параметре commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Указатель на массив имен файлов общего хранилища. Эти файлы должны быть восстановлены в то же время и так же, как файлы общего хранилища, запрошенные SisCSFilesToBackupForLink.
Если значение параметра countOfCommonStoreFilesToRestore не равно 0, значение параметра commonStoreFilesToRestore будет содержать имена файлов common-store, которые будут восстановлены в результате восстановления ссылки SIS. Если значение равно 0, то либо файлы общего хранилища были возвращены один раз, либо они уже присутствуют на томе.
Возвращаемое значение
Эта функция возвращает значение TRUE в случае успешного завершения, а в противном случае — false . Вызовите Метод GetLastError , чтобы получить дополнительные сведения о причине сбоя вызова.
Комментарии
Эту функцию следует вызывать для каждой восстановленной ссылки SIS.
Эта функция возвращает каждый общий файл хранилища не более одного раза для каждой операции восстановления; Любая попытка восстановить дополнительные ссылки SIS, которые видят тот же файл common-store, не приведет к возврату имени файла common-store.
Эта функция не возвращает файл общего хранилища, который также не был возвращен при вызове SisCSFilesToBackupForLink во время операции резервного копирования, при условии, что данные повторного анализа SIS, хранящиеся на носителе, не повреждены.
При восстановлении ссылки SIS операция восстановления должна создать только соответствующий разреженный файл, инициализировать все выделенные диапазоны, а затем записать данные повторного анализа SIS точно так, как они были прочитаны во время операции резервного копирования. Очень важно, чтобы операция восстановления создавала разреженные файлы с нераспределенным диапазоном, а не разреженные файлы (или неспаральные файлы), инициализированные нулями.
Обратите внимание, что эта функция не обязательно определяет файл общего хранилища или файлы, соответствующие набору ссылок SIS на носителе резервного копирования, если эти файлы или файлы общего хранилища по-прежнему существуют на диске. Содержимое потока данных файла общего хранилища никогда не изменяется после его создания, поэтому, если файл уже существует на диске, его не нужно восстанавливать.
Имена файлов в общем хранилище являются глобально уникальными для обеспечения целостности операции восстановления, даже если она не выполняется на томе с поддержкой SIS, к которому была доступна операция резервного копирования.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|