Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
[Начиная с 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 . Возможные возвращаемые значения включают следующие значения.
| Возврат кода или значения | Description |
|---|---|
|
Свойства были возвращены успешно. |
|
Некоторые, но не все свойства были успешно извлечены. Обратите внимание, что существует множество возможных причин, по которым не удалось получить все свойства, включая удаление устройства. |
Замечания
В VDS_DISK_PROP2 структуре , возвращаемой в параметре pDiskProperties , член pwszDiskAddress является необязательным и может иметь значение NULL , если значение недоступно. Вызывающие элементы этого метода должны проверить, имеет ли этот член значение NULL.
Для Hyper-V член pwszLocationPath имеет значение NULL, так как виртуальный контроллер не возвращает путь к расположению.
Требования
| Требование | Ценность |
|---|---|
| Минимальный поддерживаемый клиент | Windows 7 [только настольные приложения] |
| минимальный поддерживаемый сервер | Windows Server 2008 R2 [только классические приложения] |
| целевая платформа | Виндоус |
| Header | vds.h |
| Library | Uuid.lib |