GetVirtualDiskPhysicalPath, fonction (virtdisk.h)
Récupère le chemin d’accès à l’objet d’appareil physique qui contient un disque dur virtuel (VHD) ou un fichier image CD ou DVD (ISO).
Syntaxe
DWORD GetVirtualDiskPhysicalPath(
[in] HANDLE VirtualDiskHandle,
[in, out] PULONG DiskPathSizeInBytes,
[out, optional] PWSTR DiskPath
);
Paramètres
[in] VirtualDiskHandle
Handle vers le disque virtuel ouvert, qui doit avoir été ouvert à l’aide de l’indicateur de VIRTUAL_DISK_ACCESS_GET_INFO. Pour plus d’informations sur l’ouverture d’un disque virtuel, consultez la fonction OpenVirtualDisk.
[in, out] DiskPathSizeInBytes
Taille, en octets, de la mémoire tampon pointée par le paramètre DiskPath.
[out, optional] DiskPath
Mémoire tampon cible pour recevoir le chemin d’accès de l’appareil de disque physique qui contient le disque virtuel.
Valeur de retour
État de la demande.
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS et le paramètre DiskPath contient un pointeur vers une chaîne remplie.
Si la fonction échoue, la valeur de retour est un code d’erreur et la valeur du contenu de la mémoire tampon référencée par le paramètre DiskPath
Remarques
Pour que la fonction GetVirtualDiskPhysicalPath réussisse, le disque virtuel référencé par le paramètre VirtualDiskHandle doit être attaché, l’objet de disque physique doit être localisé par le système et le paramètre DiskPath doit faire référence à une mémoire tampon suffisamment grande pour contenir le chemin obtenu. Ce chemin est sous la forme \\.\PhysicalDriveX où X est un entier qui représente l’énumération particulière du disque physique sur le système de l’appelant.
Les fichiers image CD et DVD (ISO) ne sont pas pris en charge avant Windows 8 et Windows Server 2012.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| plateforme cible | Windows |
| d’en-tête | virtdisk.h |
| bibliothèque | VirtDisk.lib |
| DLL | VirtDisk.dll |