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

Метод IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea (vsmgmt.h)

  • Статья

Метод AddDiffArea добавляет связь с областью хранения теневого копирования для указанного тома. Если связь не поддерживается, возвращается код ошибки.

Синтаксис

HRESULT AddDiffArea(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Параметры

[in] pwszVolumeName

Имя тома, который будет источником теневых копий. Этот том связан с областью хранилища теневого копирования на томе pwszDiffAreaVolumeName .

Имя тома должно иметь один из следующих форматов и включать в себя обратную косую черту в конце (\):

  • Путь к подключенной папке, например Y:\MountX\
  • Буква диска, например D:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)

[in] pwszDiffAreaVolumeName

Имя тома, который будет содержать область хранения теневых копий, которая будет связана с томом pwszVolumeName .

Имя тома должно иметь один из следующих форматов и включать в себя обратную косую черту в конце (\):

  • Путь к подключенной папке
  • Буква диска, например D:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)

[in] llMaximumDiffSpace

Максимальный размер (в байтах) хранилища теневого копирования на томе. Это значение должно быть не менее 320 МБ в пределах всей системы. Если это значение равно –1, максимальный размер не ограничен.

Windows Server 2003: До Выпуска Windows Server 2003 с пакетом обновления 1 (SP1) размер хранилища теневых копий фиксировался в 100 МБ.

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

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
 Успешно добавлена связь с областью хранения теневого копирования.
E_ACCESSDENIED
 Вызывающий объект не имеет достаточных привилегий для резервного копирования или не является администратором.
E_INVALIDARG
 Одно из значений параметра недопустимо.
E_OUTOFMEMORY
 У вызывающего объекта не хватает памяти или других системных ресурсов.
VSS_E_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 На исходный том теневого копирования добавлено максимальное количество областей хранения теневых копий. Указанный том хранилища теневого копирования не был связан с указанным исходным томом теневого копирования.
VSS_E_NESTED_VOLUME_LIMIT
 Указанный том слишком глубоко вложен для участия в операции VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Этот код возврата не поддерживается.
VSS_E_OBJECT_ALREADY_EXISTS
 Связь между томами pwszVolumeName и pwszDiffAreaVolumeName уже существует.
VSS_E_PROVIDER_VETO
 Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
VSS_E_UNEXPECTED
 Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.
VSS_E_VOLUME_NOT_SUPPORTED
 Том pwszDiffAreaVolumeName не является томом NTFS или имеет недостаточно свободного места.

Комментарии

Невозможно создать связь с областью хранения теневого копирования, если для тома pwszVolumeName уже существуют теневые копии или для этого тома уже существует связь с областью хранения теневого копирования.

Область хранилища теневого копирования для исходного тома виртуального жесткого диска (VHD) должна находиться на томе. Аналогичным образом, область хранения теневого копирования может быть создана на томе VHD, только если исходный том одинаков для обоих томов.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Виртуальные жесткие диски не поддерживаются.

Чтобы изменить размер хранилища теневых копий, используйте метод IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize или IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx . Вы можете удалить область хранения теневого копирования, изменив ее размер на ноль.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vsmgmt.h

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

IVssDifferentialSoftwareSnapshotMgmt