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


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

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

Не поддерживается.

Этот метод зарезервирован для использования в будущем.

Синтаксис

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Параметры

[in] OldDiskId

GUID старого диска.

[in] NewDiskId

ИДЕНТИФИКАТОР GUID нового диска.

[out] ppAsync

Адрес указателя интерфейса IVdsAsync , который VDS инициализирует при возврате. Вызывающие стороны должны освободить интерфейс. Используйте этот интерфейс для отмены, ожидания или запроса состояния операции.

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

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

Возвращаемый код/значение Описание
S_OK
Замена диска успешно завершена.
VDS_E_NOT_SUPPORTED
0x80042400L
Этот метод не поддерживается в данной версии.

Комментарии

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

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

Реализующие объекты должны возвращать указатель на интерфейс IVdsAsync для этого метода, независимо от того, инициирует ли вызов асинхронную операцию. Если поставщик не реализует горячее щадя, он должен поддерживать сценарий отказа члена: снова начать синхронизацию доступного отказоустойчивого тома после вызова метода ReplaceDisk .

Требования

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