Метод IVssHardwareSnapshotProviderEx::ResyncLuns (vsprov.h)

Статья
07/16/2024

Служба VSS вызывает этот метод, чтобы уведомить поставщиков оборудования о необходимости повторной синхронизации LUN.

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

Синтаксис

HRESULT ResyncLuns(
  [in]  VDS_LUN_INFORMATION *pSourceLuns,
  [in]  VDS_LUN_INFORMATION *pTargetLuns,
  [in]  DWORD               dwCount,
  [out] IVssAsync           **ppAsync
);

Параметры

[in] pSourceLuns

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

[in] pTargetLuns

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

[in] dwCount

Количество элементов в массиве pSourceLuns. Это также число элементов в массиве pTargetLuns.

[out] ppAsync

Указатель на расположение, которое получит указатель интерфейса IVssAsync, который можно использовать для получения состояния операции повторной синхронизации. После завершения операции вызывающий объект должен освободить указатель интерфейса, вызвав метод IUnknown::Release.

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

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

Возврат кода или значения	Описание
S_OK 0x000000000L	Операция успешно завершена.
E_OUTOFMEMORY 0x800700EL	Вне памяти или других системных ресурсов.
VSS_E_PROVIDER_VETO 0x80042306L	Произошла непредвиденная ошибка поставщика. Если этот код ошибки возвращается, ошибка должна быть описана в записи в журнале событий приложения, предоставляя пользователю сведения о том, как устранить проблему.
VSS_E_INSUFFICIENT_STORAGE 0x8004231FL	Поставщик не может выполнить операцию, так как недостаточно места на диске.

Замечания

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

Поставщик должен выполнить повторную синхронизацию путем копирования данных на уровне массива LUN, а не на уровне узла. Это означает, что поставщик не может реализовать повторную синхронизацию LUN, просто копируя содержимое исходного LUN в целевой LUN. Операции ввода-вывода, необходимые для выполнения повторной синхронизации LUN, должны выполняться на оборудовании с помощью дисковых устройств повторной синхронизации LUN, а не через главный компьютер. Этот ввод-вывод должен быть полностью прозрачным для хост-компьютера.

После завершения повторной синхронизации LUN полностью функциональны и доступны для операций ввода-вывода.

Базовое оборудование диска должно поддерживать уникальные идентификаторы устройств на странице 83.

Если целевой LUN больше исходного LUN, поставщик должен изменить размер целевого LUN при необходимости, чтобы убедиться, что он соответствует исходному LUN после повторной синхронизации.

Этот метод нельзя вызвать в WinPE, и его нельзя вызвать в безопасном режиме. Перед вызовом этого метода вызывающий объект должен использовать метод IVssBackupComponents::InitializeForRestore для подготовки к повторной синхронизации.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Не поддерживается
минимальный поддерживаемый сервер	Windows Server 2008 R2 [только классические приложения]
целевая платформа	Виндоус
заголовка	vsprov.h

См. также

IVssHardwareSnapshotProviderEx

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