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


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

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

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

Синтаксис

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Параметры

[out] pVolumeProperties

Адрес структуры VDS_VOLUME_PROP2 , выделенной и переданной вызывающим объектом. VDS выделяет память для строки члена pwszName . Вызывающие стороны должны освободить строку с помощью функции CoTaskMemFree .

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

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

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

Комментарии

Этот метод извлекает уникальный идентификатор тома для тома. Структура, содержащая этот идентификатор, является VDS_VOLUME_PROP2, а не VDS_VOLUME_PROP.

Обратите внимание, что уникальный идентификатор тома не совпадает с путем GUID тома. Чтобы найти пути GUID тома, используйте метод IVdsVolumeMF3::QueryVolumeGuidPathnames .

Требования

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

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

IVdsVolume2