Метод IVssCreateExpressWriterMetadata::AddFilesToFileGroup (vswriter.h)

Статья
08/27/2023

Добавляет набор файлов (указанный файл или файлы) в указанный компонент группы файлов для модуля записи express.

Синтаксис

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, которая содержит корневой каталог добавляемых файлов по умолчанию.

Путь может содержать переменные среды (например, %SystemRoot%), но не может содержать подстановочные знаки.

Нет необходимости заканчивать путь обратной косой чертой (\). Только приложения, которые извлекают эти сведения в проверка.

[in] wszFilespec

Указатель на строку расширенных символов, завершающуюся null, которая содержит спецификацию файла для включаемых файлов.

Спецификация файла не может содержать спецификации каталога (например, без обратных косых черт), но может содержать ? и * подстановочные знаки.

[in] bRecursive

Логическое значение, указывающее, определяет ли путь, заданный параметром wszPath , только один каталог или указывает иерархию каталогов для рекурсивного просмотра. Этот параметр должен иметь значение true , если путь рассматривается как иерархия каталогов для рекурсии, или false в противном случае.

Сведения о обходе подключенных папок см. в разделах Работа с подключенными папками и Точки повторного анализа.

[in] wszAlternateLocation

Этот параметр зарезервирован и должен иметь значение NULL.

[in] dwBackupTypeMask

Битовая маска VSS_FILE_SPEC_BACKUP_TYPE значения перечисления, указывающие, должен ли модуль записи оценивать файл для участия в определенных типах операций резервного копирования.

Этот параметр не может включать VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED или VSS_FSBT_LOG_BACKUP_REQUIRED.

Значение по умолчанию для этого аргумента — (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

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

Ниже приведены допустимые коды возврата для этого метода.

Значение	Значение
S_OK	Операция выполнена успешно.
E_INVALIDARG	Одно из значений параметра является недопустимым, или вызывающий объект пытался добавить файлы файловой группы в компонент, отличный от файловой группы.
E_OUTOFMEMORY	У вызывающего объекта не хватает памяти или других системных ресурсов.
VSS_E_INVALID_XML_DOCUMENT	Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
VSS_E_OBJECT_NOT_FOUND	Указанный компонент не существует.
VSS_E_UNEXPECTED	Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в 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
Header	vswriter.h (включая Vss.h, VsWriter.h)
Библиотека	VssApi.lib

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

IVssCreateExpressWriterMetadata

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