GetVirtualDiskInformation-Funktion (virtdisk.h)

Ruft Informationen zu einer virtuellen Festplatte (VHD) ab.

Syntax

DWORD GetVirtualDiskInformation(
  [in]                HANDLE                 VirtualDiskHandle,
  [in, out]           PULONG                 VirtualDiskInfoSize,
  [in, out]           PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
  [in, out, optional] PULONG                 SizeUsed
);

Parameter

[in] VirtualDiskHandle

Ein Handle für die geöffnete VHD, die mithilfe des VIRTUAL_DISK_ACCESS_GET_INFO-Flags geöffnet worden sein muss, das im VirtualDiskAccessMask-Parameter auf die OpenVirtualDisk-Funktion festgelegt ist . Informationen zum Öffnen einer VHD finden Sie in der OpenVirtualDisk-Funktion .

[in, out] VirtualDiskInfoSize

Ein Zeiger auf eine ULONG , die die Größe des VirtualDiskInfo-Parameters enthält.

[in, out] VirtualDiskInfo

Ein Zeiger auf eine gültige GET_VIRTUAL_DISK_INFO-Struktur . Das Format der zurückgegebenen Daten hängt von dem Wert ab, der im Member Version vom Aufrufer übergeben wird.

[in, out, optional] SizeUsed

Ein Zeiger auf eine ULONG , die die verwendete Größe enthält.

Rückgabewert

Status der Anforderung.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS und der VirtualDiskInfo-Parameter enthält die angeforderten Informationen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, und der VirtualDiskInfo-Parameter ist nicht definiert. Weitere Informationen finden Sie unter Systemfehlercodes.

Hinweise

Die GetVirtualDiskInformation-Funktion kann für jede gültige VirtualDiskHandle-Instanz aufgerufen werden, vorausgesetzt, das Handle wurde mit dem VIRTUAL_DISK_ACCESS_GET_INFO-Flag geöffnet. Die VHD muss kein angefügter Datenträger sein.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	virtdisk.h
Bibliothek	VirtDisk.lib
DLL	VirtDisk.dll

Weitere Informationen

Informationen zu VHD

GET_VIRTUAL_DISK_INFO

VHD-Referenz