Метод IVdsDisk3::GetProperties2 (vds.h)

  • Статья

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

Возвращает сведения о свойстве диска. Этот метод идентичен методу IVdsDisk::GetProperties , за исключением того, что он возвращает VDS_DISK_PROP2 структуру вместо структуры VDS_DISK_PROP .

Синтаксис

HRESULT GetProperties2(
  [out] VDS_DISK_PROP2 *pDiskProperties
);

Параметры

[out] pDiskProperties

Адрес структуры VDS_DISK_PROP2 , выделенной и переданной вызывающим объектом. VDS выделяет память для строк элементов pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath и pwszLocationPath . Вызывающие стороны должны освободить строки с помощью функции CoTaskMemFree .

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

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

Возвращаемый код или значение Описание
S_OK
 Свойства были успешно возвращены.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
 Некоторые, но не все свойства были успешно получены. Обратите внимание, что существует множество причин, по которым не удается получить все свойства, включая удаление устройства.

Комментарии

В структуре VDS_DISK_PROP2 , возвращаемой в параметре pDiskProperties , член pwszDiskAddress является необязательным и может иметь значение NULL , если значение недоступно. Вызывающие методы должны проверять, имеет ли этот элемент значение NULL.

Для Hyper-V член pwszLocationPath имеет значение NULL, так как виртуальный контроллер не возвращает путь к расположению.

Требования

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

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

IVdsDisk3

VDS_DISK_PROP2