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

Статья
03/03/2024

Метод 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 , не поддерживается.

Требования

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

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

IVssHardwareSnapshotProvider

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

Share via