Функция SisCSFilesToBackupForLink

Статья
06/12/2023

Функция SisCSFilesToBackupForLink возвращает сведения, описывающие файлы общего хранилища, на которые указывает указанная ссылка SIS.

Синтаксис

BOOL SisCSFilesToBackupForLink(
  _In_  PVOID  sisBackupStructure,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PVOID  thisFileContext,
  _Out_ PVOID  *matchingFileContext,
  _Out_ PULONG countOfCommonStoreFilesToBackUp,
  _Out_ PWCHAR **commonStoreFilesToBackUp
);

Параметры

sisBackupStructure [in]: Указатель на структуру резервного копирования SIS, возвращенную из SisCreateBackupStructure.
reparseData [in]: Указатель на содержимое точки повторного аналитики SIS. Эта точка повторного анализа содержит данные, описывающие ссылку SIS. Чтобы получить данные точки повторного анализа для файла, используйте код элемента управления FSCTL_GET_REPARSE_POINT .
reparseDataSize [in]: Размер содержимого точки повторного раздела SIS, на которую указывает reparseData, в байтах.
thisFileContext [out]: Указатель на строку контекста, предоставленную приложением резервного копирования, вызывающим эту функцию. Содержимое этой строки содержимого полностью определяется этим приложением резервного копирования и не интерпретируется API резервного копирования SIS. Этот параметр является необязательным; Если не используется, задайте для этого параметра значение NULL. Значение этого параметра в этом случае не будет обработано.
matchingFileContext [out]: Двойной косвенный указатель на строку контекста связи SIS, определяемую данными, переданными в первых четырех параметрах этой функции. Этот параметр является необязательным; Если строка контекста не указана в качестве значения параметра thisFileContext , задайте для этого параметра значение NULL. Значение этого параметра в этом случае не будет обработано.
countOfCommonStoreFilesToBackUp [out]: Количество файлов, перечисленных в параметре commonStoreFilesToBackUp .
commonStoreFilesToBackUp [out]: Указатель на массив имен файлов. Резервное копирование этих файлов должно выполняться в то же время и так же, как и файлы common-store, запрашиваемые SisCreateBackupStructure.

Возвращаемое значение

Эта функция возвращает true , если она завершается успешно, и false в противном случае. Вызовите Метод GetLastError , чтобы получить дополнительные сведения о причине сбоя вызова.

Если эта точка повторного просмотра, определяемая значением параметра reparseData , описывает первый экземпляр файла для резервного копирования, эта функция вернет значение NULL в качестве значения параметра matchingFileContext и инициализирует значение массива строк commonStoreFilesToBackUp с именами файла или файлов для резервного копирования. В противном случае эта функция устанавливает для параметра matchingFileContext значение контекстной строки, соответствующей первому экземпляру указанного файла, и устанавливает для параметра countOfCommonStoreFilesToBackUp значение 0. При наличии нескольких файлов common-store, соответствующих указанной ссылке, значением параметра thisFileContext будет строка контекста, соответствующая первому файлу common-store, возвращенному в массиве, то есть commonStoreFilesToBackUp[0].

Текущая версия этой функции будет возвращать не более одного файла общего хранилища, но в будущих версиях одна ссылка может поддерживаться несколькими файлами общего хранилища, например, по одному для каждого потока в файле, поэтому приложение резервного копирования должно поддерживать несколько файлов в каждом вызове этой функции. В любом случае каждый файл common-store возвращается не более одного раза для каждого прохода резервного копирования.

Приложение резервного копирования должно выполнять резервное копирование или восстановление файлов общего хранилища или файлов, определенных по имени файла или именам файлов, возвращенным в параметре commonStoreFilesToBackUp . Независимо от того, есть ли соответствующий файл общего хранилища, приложение резервного копирования должно создать резервную копию файла ссылки SIS, который существует на диске, например в виде точки повторного определения и разреженного файла, и, скорее всего, без заполненных диапазонов. Приложение резервного копирования может немедленно создать резервную копию или восстановить файлы общего хранилища, отложить их резервное копирование или смешивать их при необходимости.

После завершения операции резервного копирования освободите память, используемую массивом строк commonStoreFilesToBackUp , вызвав SisFreeAllocatedMemory.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Sisbkup.h
Библиотека	Sisbkup.lib
DLL	Sisbkup.dll

См. также раздел

SisFreeAllocatedMemory
SisCreateBackupStructure

Поделиться через