Метод IVdsPack::MigrateDisks (vds.h)

Статья
03/08/2023

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Переносит набор дисков из одного пакета в другой.

Синтаксис

HRESULT MigrateDisks(
  [in]  VDS_OBJECT_ID *pDiskArray,
  [in]  LONG          lNumberOfDisks,
  [in]  VDS_OBJECT_ID TargetPack,
  [in]  BOOL          bForce,
  [in]  BOOL          bQueryOnly,
  [out] HRESULT       *pResults,
  [out] BOOL          *pbRebootNeeded
);

Параметры

[in] pDiskArray

Указатель на массив GUID; по одному для каждого диска.

[in] lNumberOfDisks

Количество дисков для миграции.

[in] TargetPack

GUID объекта pack.

[in] bForce

Если для этого параметра задано значение TRUE, VDS игнорирует все ошибки из этого метода и пытается выполнить миграцию дисков безоговорочно. Если задано значение FALSE, операция не продолжается. В некоторых случаях принудительная миграция может привести к потере данных.

[in] bQueryOnly

Если для этого параметра задано значение TRUE, миграция не выполняется. Если задано значение FALSE, операция продолжается.

[out] pResults

Адрес выделенного вызывающим объектом массива значений HRESULT . Количество элементов в массиве — lNumberOfDisks.

Если диск может быть перенесен или успешно перенесен, соответствующий элемент массива получает S_OK; в противном случае он получает код предупреждения или ошибки, возвращенный поставщиком. Список дополнительных кодов результатов см. в разделе Возвращаемые значения.

[out] pbRebootNeeded

Если для этого параметра задано значение TRUE, необходимо перезагрузить компьютер, чтобы завершить операцию. Если задано значение FALSE, операция завершается без перезапуска.

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

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код/значение	Описание
S_OK	Миграция успешно завершена.
S_FALSE	По крайней мере один из дисков не может быть преобразован или может быть преобразован с предупреждением.
VDS_E_DISK_NOT_ONLINE 0x8004244BL	Один из дисков недоступен.
VDS_E_IMPORT_SET_INCOMPLETE 0x80042451L	Предпринята попытка импорта подмножества дисков во внешнем пакете.

С помощью pResults можно вернуть следующие предупреждения и ошибки:

Возвращаемый код/значение	Описание
VDS_S_BOOT_PARTITION_NUMBER_CHANGE 0x00042436L	Номер секции загрузочного раздела изменился в результате операции миграции.
VDS_E_NO_FREE_SPACE 0x80042437L	На выбранном диске недостаточно свободного места для выполнения операции.
VDS_E_ACTIVE_PARTITION 0x80042438L	На выбранном диске обнаружен активный раздел, который не используется для загрузки активной операционной системы.
VDS_E_PARTITION_OF_UNKNOWN_TYPE 0x80042439L	Невозможно прочитать сведения о секции.
VDS_E_LEGACY_VOLUME_FORMAT 0x8004243AL	На выбранном диске обнаружен раздел неизвестного типа.
VDS_E_NON_CONTIGUOUS_DATA_PARTITIONS 0x8004243BL	Выбранный диск GPT содержит не базовую секцию данных, перед которой следует один или несколько базовых разделов данных.
VDS_E_MIGRATE_OPEN_VOLUME 0x8004243CL	Невозможно открыть том на выбранном диске.

Эту операцию следует принудительно выполнить при преобразовании базового диска в динамический формат диска, а в конце диска недостаточно места для базы данных LDM. Задайте для параметра bForceзначение true и принудительная операция, несмотря на ограничение пространства. Аналогичным образом, если раздел OEM находится в середине диска MBR со свободным местом или томами данных на обеих сторонах.

После переноса динамических дисков в динамический пакет следует использовать метод IVdsPack::GetProperties , чтобы определить, является ли исходный или конечный пакет пакетом в сети.

Сведения об использовании метода MigrateDisks для добавления внешних дисков в пакет см. в статье Добавление внешних дисков в пакет.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

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

IVdsPack

IVdsPack::GetProperties

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