Метод 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 . Возможные возвращаемые значения включают следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Метод завершился успешно. |
|
Некоторые, но не все свойства были успешно получены. Обратите внимание, что существует множество возможных причин, по которым не удается получить все свойства, включая удаление устройства. |
Комментарии
Этот метод извлекает уникальный идентификатор тома для тома. Структура, содержащая этот идентификатор, является VDS_VOLUME_PROP2, а не VDS_VOLUME_PROP.
Обратите внимание, что уникальный идентификатор тома не совпадает с путем GUID тома. Чтобы найти пути GUID тома, используйте метод IVdsVolumeMF3::QueryVolumeGuidPathnames .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vds.h |
| Библиотека | Uuid.lib |