ExpandVirtualDisk, fonction (virtdisk.h)
Augmente la taille d’un disque dur virtuel fixe ou dynamiquement extensible.
Syntaxe
DWORD ExpandVirtualDisk(
[in] HANDLE VirtualDiskHandle,
[in] EXPAND_VIRTUAL_DISK_FLAG Flags,
[in] PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
[in, optional] LPOVERLAPPED Overlapped
);
Paramètres
[in] VirtualDiskHandle
Handle du disque virtuel ouvert, qui doit avoir été ouvert à l’aide de l’indicateur VIRTUAL_DISK_ACCESS_METAOPS . Pour plus d’informations sur l’ouverture d’un disque virtuel, consultez la fonction OpenVirtualDisk .
[in] Flags
Doit être la valeur EXPAND_VIRTUAL_DISK_FLAG_NONE de l’énumération EXPAND_VIRTUAL_DISK_FLAG .
[in] Parameters
Pointeur vers une structure EXPAND_VIRTUAL_DISK_PARAMETERS valide qui contient des données de paramètres d’expansion.
[in, optional] Overlapped
Pointeur facultatif vers une structure CHEVAUCHEMENT VALIDE si une opération asynchrone est souhaitée.
Valeur retournée
Statut de la demande.
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur. Pour plus d’informations, consultez Codes d’erreur système.
Remarques
La fonction ExpandVirtualDisk effectue l’opération sur place et ne crée donc pas de disque virtuel.
L’opération de développement est valide uniquement pour les disques virtuels fixes et extensibles et invalide une chaîne de disques virtuels de différenciation.
Le développement d’un disque virtuel nécessite que le disque virtuel soit détaché pendant l’opération.
L’appelant doit avoir READ|Accès EN ÉCRITURE au magasin de stockage pour le disque virtuel.
Pour un disque virtuel extensible, la fonction ExpandVirtualDisk peut ne pas entraîner un fichier plus volumineux, car la taille est virtuelle et ne croîtra pas physiquement tant qu’elle n’est pas utilisée.
Si le disque virtuel est extensible et que le volume hôte n’a pas suffisamment d’espace pour la nouvelle taille, la fonction ExpandVirtualDisk peut de toute façon réussir. Les écritures ultérieures sur le disque virtuel peuvent échouer si le volume hôte manque d’espace à mesure que le disque virtuel se développe.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |