Метод IVssCreateWriterMetadata::AddFilesToFileGroup (vswriter.h)
Метод AddFilesToFileGroup добавляет набор файлов (указанный файл или файлы) в указанный компонент группы файлов.
Синтаксис
HRESULT AddFilesToFileGroup(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszGroupName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszAlternateLocation,
[in] DWORD dwBackupTypeMask
);
Параметры
[in] wszLogicalPath
Указатель на строку расширенных символов, завершающуюся null, содержащую логический путь (который может иметь значение NULL) компонента, к которому добавляются файлы. Дополнительные сведения см. в разделе Логический путь к компонентам.
[in] wszGroupName
Указатель на строку расширенных символов, завершающуюся null, которая содержит имя компонента файловой группы. Тип этого компонента должен быть VSS_CT_FILEGROUP; В противном случае метод вернет ошибку.
[in] wszPath
Указатель на строку расширенных символов, завершающуюся null, которая содержит корневой каталог добавляемых файлов по умолчанию.
Каталог может быть локальным каталогом на компьютере VSS или каталогом общей папки на удаленном файловом сервере.
Поддерживаются UNC-пути.
Путь может содержать переменные среды (например, %SystemRoot%), но не может содержать подстановочные знаки.
Не требуется, чтобы путь заканчивалась обратной косой чертой (""). Только приложения, которые извлекают эти сведения в проверка.
[in] wszFilespec
Указатель на строку расширенных символов, завершающуюся null, которая содержит спецификацию файла для включаемых файлов.
Спецификация файла не может содержать спецификации каталога (например, без обратных косых черт), но может содержать ? и * подстановочные знаки.
[in] bRecursive
Логическое значение, указывающее, определяет ли путь, заданный параметром wszPath , только один каталог или указывает иерархию каталогов для рекурсивного просмотра. Этот параметр должен иметь значение true , если путь рассматривается как иерархия каталогов для рекурсии, или false в противном случае.
Сведения о обходе подключенных папок см. в разделах Работа с подключенными папками и Точки повторного анализа.
[in] wszAlternateLocation
Указатель на строку расширенных символов, завершающуюся null, содержащую альтернативный путь, который фактически содержит файлы для резервного копирования с помощью этого компонента.
Каталог может быть локальным каталогом на компьютере VSS или каталогом общей папки на удаленном файловом сервере.
Поддерживаются UNC-пути.
Указание альтернативного пути является необязательным; Если альтернативный путь не требуется, wszAlternatePath должен иметь значение NULL.
Альтернативный путь не следует путать с сопоставлением альтернативного расположения.
[in] dwBackupTypeMask
Битовая маска VSS_FILE_SPEC_BACKUP_TYPE значения перечисления, указывающие, должен ли модуль записи оценивать файл для участия в определенных типах операций резервного копирования.
Значение по умолчанию для этого аргумента — (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Операция выполнена успешно. |
|
Одно из значений параметра является недопустимым, или вызывающий объект пытался добавить файлы файловой группы в компонент, отличный от файловой группы. |
|
У вызывающего объекта не хватает памяти или других системных ресурсов. |
|
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Для модулей записи express значение wszAlternatePath должно иметь значение NULL, а битовая маска dwBackupTypeMask не может включать VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED или VSS_FSBT_LOG_BACKUP_REQUIRED. |
|
Указанный компонент не существует. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
Комментарии
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP и Windows Server 2003: Удаленные общие папки не поддерживаются до Windows 8 и Windows Server 2012. Средства записи поддерживают только локальные ресурсы — наборы файлов, абсолютный путь которых начинается с допустимой спецификации локального тома и не может быть сопоставленным сетевым диском. Поэтому входные путь (wszPath и wszAlternatePath) к AddFilesToFileGroup (после разрешения любых переменных среды) должны иметь этот формат.
Модуль записи может вызывать этот метод несколько раз, чтобы добавить несколько наборов файлов в компонент группы файлов. Однако следует убедиться, что спецификации файла не перекрываются, так как конкретный файл можно указать только один раз.
Расположения, из которых создаются резервные копии файлов и в которые они восстанавливаются, зависят от значений корневого каталога, определенного wszPath , и альтернативного пути, определенного wszAlternatePath.
При использовании сведений о пути, предоставляемых AddFilesToFileGroup, обратите внимание на следующее:
- Операции восстановления должны (по возможности) восстанавливать файлы, добавленные в компонент AddFilesToFileGroup в корневом каталоге по умолчанию, определенном wszPath.
- Если альтернативный путь не указан (если wszAlternatePath имеет значение NULL), то файлы, добавленные в компонент, будут архивированы из корневого каталога по умолчанию и восстановлены в корневой каталог по умолчанию, указанный wszPath.
- Если указан альтернативный путь (если wszAlternatePath имеет значение, отличное от NULL), резервные копии файлов, добавленных в компонент, создаются по альтернативному пути, заданному wszAlternatePath. Однако инициаторы запроса по-прежнему будут использовать wszPath в качестве расположения восстановления по умолчанию.
- Если определен альтернативный путь (wszAlternatePath не имеет значения NULL) и в альтернативном пути и корневом каталоге по умолчанию (wszPath) есть файлы, соответствующие спецификации файла (wszFilespec), то операция резервного копирования должна создавать резервные копии файлов, расположенных по альтернативному пути, а не файлов, расположенных в корневом каталоге по умолчанию.
- Файлы следует восстанавливать в каталог, указанный wszPath , если только iVssCreateWriterMetadata::AddAlternateLocationMapping не задал альтернативное сопоставление расположения, а это требуется для метода восстановления или целевого объекта восстановления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |