Метод 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).

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

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

Значение Значение
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 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

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

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent