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

Метод IVssHardwareSnapshotProvider::BeginPrepareSnapshot (vsprov.h)

  • Статья

Метод BeginPrepareSnapshot вызывается для каждой теневой копии, добавляемой в набор теневого копирования.

Примечание Поставщики оборудования поддерживаются только в операционных системах Windows Server.
 

Синтаксис

HRESULT BeginPrepareSnapshot(
  [in]      VSS_ID              SnapshotSetId,
  [in]      VSS_ID              SnapshotId,
  [in]      LONG                lContext,
  [in]      LONG                lLunCount,
  [in]      VSS_PWSZ            *rgDeviceNames,
  [in, out] VDS_LUN_INFORMATION *rgLunInformation
);

Параметры

[in] SnapshotSetId

Идентификатор набора теневого копирования.

[in] SnapshotId

Идентификатор создаваемой теневой копии.

[in] lContext

Контекст теневого копирования для текущего набора теневого копирования, перечисляемого _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] lLunCount

Количество LUN, влияющих на этот том теневого копирования.

[in] rgDeviceNames

Указатель на массив указателей lLunCount на строки, каждая из которых содержит имя LUN, копируемый тенью.

[in, out] rgLunInformation

Указатель на массив структур VDS_LUN_INFORMATIONlLunCount, по одному для каждого LUN, способствующего созданию этого тома теневого копирования.

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

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

Возвращаемый код или значение Описание
S_OK
0x00000000L
 Операция успешно завершена.
E_OUTOFMEMORY
0x8007000EL
 Нехватка памяти или других системных ресурсов.
E_INVALIDARG
0x80070057L
 Одно из значений параметра является недопустимым.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 Поставщик достиг максимального количества томов, которые он может поддерживать.
VSS_E_NESTED_VOLUME_LIMIT
 Указанный том слишком глубоко вложен для участия в операции VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Этот код возврата не поддерживается.
VSS_E_PROVIDER_VETO
0x80042306L
 Произошла непредвиденная ошибка поставщика. Поставщик должен сообщить о событии в журнале событий приложения, предоставляя пользователю сведения о том, как устранить проблему.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 Поставщик не поддерживает этот том.
VSS_E_UNSUPPORTED_CONTEXT
0x8004231BL
 Контекст, заданный lContext , не поддерживается.

Комментарии

Этот метод не может быть вызван для виртуального жесткого диска (VHD), вложенного в другой виртуальный жесткий диск.

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

Требования

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

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

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES