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

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

  • Статья

[Начиная с 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. После возврата этого метода диск будет принадлежать базовому поставщику.

Чтобы отменить действие этого метода, то есть удалить формат секционирования и сделать диск необработанным диском, принадлежащим службе 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