GetVirtualDiskInformation, fonction (virtdisk.h)
Récupère des informations sur un disque dur virtuel (VHD).
Syntaxe
DWORD GetVirtualDiskInformation(
[in] HANDLE VirtualDiskHandle,
[in, out] PULONG VirtualDiskInfoSize,
[in, out] PGET_VIRTUAL_DISK_INFO VirtualDiskInfo,
[in, out, optional] PULONG SizeUsed
);
Paramètres
[in] VirtualDiskHandle
Handle du disque dur virtuel ouvert, qui doit avoir été ouvert à l’aide de l’indicateur VIRTUAL_DISK_ACCESS_GET_INFO défini dans le paramètre VirtualDiskAccessMask sur la fonction OpenVirtualDisk . Pour plus d’informations sur l’ouverture d’un disque dur virtuel, consultez la fonction OpenVirtualDisk .
[in, out] VirtualDiskInfoSize
Pointeur vers un ULONG qui contient la taille du paramètre VirtualDiskInfo .
[in, out] VirtualDiskInfo
Pointeur vers une structure GET_VIRTUAL_DISK_INFO valide. Le format des données retournées dépend de la valeur passée dans le membre Version par l’appelant.
[in, out, optional] SizeUsed
Pointeur vers un ULONG qui contient la taille utilisée.
Valeur retournée
Statut de la demande.
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et le paramètre VirtualDiskInfo contient les informations demandées.
Si la fonction échoue, la valeur de retour est un code d’erreur et le paramètre VirtualDiskInfo n’est pas défini. Pour plus d’informations, consultez Codes d’erreur système.
Remarques
La fonction GetVirtualDiskInformation peut être appelée sur n’importe quel VirtualDiskHandle valide, à condition que le handle ait été ouvert à l’aide de l’indicateur VIRTUAL_DISK_ACCESS_GET_INFO . Le disque dur virtuel n’est pas obligatoirement un disque attaché.
Configuration requise
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| Plateforme cible | Windows |
| En-tête | virtdisk.h |
| Bibliothèque | VirtDisk.lib |
| DLL | VirtDisk.dll |