Функция 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

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

Сведения о виртуальном жестком диске

GET_VIRTUAL_DISK_INFO

Справочник по VHD