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

Статья
03/08/2023

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

Добавляет диск в интерактивный пакет.

Синтаксис

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Параметры

[in] DiskId

GUID диска.

[in] PartitionStyle

Стиль может быть MBR или GPT. См. перечисление VDS_PARTITION_STYLE .

[in] bAsHotSpare

Если значение равно true, VDS может использовать диск в качестве горячего резерва; В противном случае диск нельзя использовать для этой операции. Только поставщики оборудования поддерживают горячее щадя.

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

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

Возвращаемый код или значение	Описание
S_OK	Диск успешно добавлен.
VDS_E_NOT_AN_UNALLOCATED_DISK 0x80042418L	Диск необработанный.
VDS_E_OPERATION_DENIED 0x8004240AL	Добавляемый диск очищается.
VDS_E_PROVIDER_FAILURE 0x80042442L	Во время операции произошел сбой поставщика.
VDS_E_NOT_SUPPORTED 0x80042400L	Добавление второго диска в базовый пакет не поддерживается.
VDS_E_PACK_OFFLINE 0x80042444L	Целевой пакет недоступен.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Диск не найден.
VDS_E_DMADMIN_METHOD_CALL_FAILED 0x80042420L	Службе диспетчера логических дисков (LDM) не удалось завершить метод.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Поврежден динамический кэш поставщика.

Этот метод инициализирует необработанный диск (диск, для которого не определено секционирование) и добавляет его в пакет. Перед вызовом этого метода необработанный диск принадлежит службе VDS. После возврата этого метода диск будет принадлежать базовому поставщику.

Чтобы отменить действие этого метода, то есть удалить формат секционирования и сделать диск необработанным диском, принадлежащим службе VDS, используйте метод IVdsAdvancedDisk::Clean .

Нельзя использовать AddDisk для переопределения секционирования на существующем диске.

При добавлении диска GPT в базовый пакет операция автоматически создает раздел MSR на диске. Устройства под управлением операционной системы WinPE являются исключением, так как администратор может предпочесть создать раздел ESP на диске. Раздел ESP, если он имеется, должен быть первым разделом на диске.

При добавлении диска в динамический пакет операция не создает раздел MSR.

Требования

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

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

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE

Share via