Метод IVssCreateWriterMetadata::AddDatabaseLogFiles (vswriter.h)
Метод AddDatabaseLogFiles указывает файлы журнала, связанные с базой данных для резервного копирования, а также их расположение.
Синтаксис
HRESULT AddDatabaseLogFiles(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszDatabaseName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] DWORD dwBackupTypeMask
);
Параметры
[in] wszLogicalPath
Указатель на строку расширенных символов, завершающуюся null, которая содержит логический путь к компоненту базы данных, в который будут добавлены файлы журнала.
Дополнительные сведения см. в разделе Логический путь компонентов.
Логический путь не является обязательным и может иметь значение NULL.
[in] wszDatabaseName
Указатель на строку расширенных символов с пустым завершением, содержащую имя компонента базы данных, связанного с файлами журнала. Тип этого компонента должен быть VSS_CT_DATABASE; В противном случае метод вернет ошибку.
[in] wszPath
Указатель на широкую символьную строку с пустым завершением, содержащую путь к каталогу с файлами журнала.
Каталог может быть локальным каталогом на компьютере VSS или каталогом общей папки на удаленном файловом сервере.
Поддерживаются UNC-пути.
Путь может содержать переменные среды (например, %SystemRoot%), но не может содержать подстановочные знаки.
Не требуется, чтобы путь заканчивалась обратной косой чертой (""). Приложения, которые извлекают эти сведения для проверка.
[in] wszFilespec
Указатель на строку расширенных символов со значением NULL, содержащую спецификацию файла журнала, связанного с базой данных.
Спецификация файла не может содержать спецификации каталога (например, без обратных косых черт), но может содержать ? и * подстановочные знаки.
[in] dwBackupTypeMask
Битовая маска (или побитовая ИЛИ) VSS_FILE_SPEC_BACKUP_TYPE значения перечисления, указывающие, должен ли модуль записи оценивать файл для участия в определенных типах операций резервного копирования.
Значение по умолчанию для этого аргумента — (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Операция выполнена успешно. |
|
Одно из значений параметра является недопустимым, или вызывающий объект пытался добавить файлы базы данных в компонент, отличный от базы данных. |
|
Вызывающий объект не имеет памяти или других системных ресурсов. |
|
Недопустимый XML-документ. Дополнительные сведения см. в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Указанный компонент не существует. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в 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) к AddDatabaseLogFiles (после разрешения любых переменных среды) должны иметь этот формат.
Этот метод можно вызывать несколько раз для определенного компонента базы данных, что может потребоваться, если несколько файлов журнала хранятся на отдельных томах.
Значения параметров wszLogicalPath и wszDatabaseName должны соответствовать значениям одного из компонентов базы данных, добавленных ранее с помощью метода IVssCreateWriterMetadata::AddComponent .
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |