Функция GetVirtualDiskInformation (virtdisk.h)
Извлекает сведения о виртуальном жестком диске (VHD).
Синтаксис
DWORD GetVirtualDiskInformation(
[in] HANDLE VirtualDiskHandle,
[in, out] PULONG VirtualDiskInfoSize,
[in, out] PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
[in, out, optional] PULONG SizeUsed
);
Параметры
[in] VirtualDiskHandle
Дескриптор открытого виртуального жесткого диска, который должен быть открыт с помощью флага VIRTUAL_DISK_ACCESS_GET_INFO , заданного в параметре VirtualDiskAccessMask для функции OpenVirtualDisk . Сведения об открытии виртуального жесткого диска см. в разделе Функция OpenVirtualDisk .
[in, out] VirtualDiskInfoSize
Указатель на ULONG , содержащий размер параметра VirtualDiskInfo .
[in, out] VirtualDiskInfo
Указатель на допустимую структуру GET_VIRTUAL_DISK_INFO . Формат возвращаемых данных зависит от значения, переданного вызывающей стороной в члене Version .
[in, out, optional] SizeUsed
Указатель на ULONG , содержащий используемый размер.
Возвращаемое значение
Состояние запроса.
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS а параметр VirtualDiskInfo содержит запрошенные сведения.
Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, а параметр VirtualDiskInfo не определен. Дополнительные сведения см. в разделе Системные коды ошибок.
Комментарии
Функцию GetVirtualDiskInformation можно вызвать для любого допустимого VirtualDiskHandle при условии, что дескриптор был открыт с помощью флага VIRTUAL_DISK_ACCESS_GET_INFO . Виртуальный жесткий диск не обязательно должен быть подключенным диском.
Требования
| Минимальная версия клиента | Windows 7 |
| Минимальная версия сервера | Windows Server 2008 R2 |
| Целевая платформа | Windows |
| Header | virtdisk.h |
| Библиотека | VirtDisk.lib |
| DLL | VirtDisk.dll |