IVdsDisk ::QueryExtents, méthode (vds.h)

Article
03/03/2024

[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]

Retourne les détails de toutes les extensions sur un disque.

Syntaxe

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

Paramètres

[out] ppExtentArray

Variable pointeur qui reçoit un
tableau de structures VDS_DISK_EXTENT . Les appelants doivent libérer ce tableau à l’aide de la fonction CoTaskMemFree .

[out] plNumberOfExtents

Adresse d’un type LONG représentant le nombre total d’étendues.

Valeur retournée

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.

Code/valeur de retour	Description
S_OK	Les informations d’étendue ont été retournées avec succès.
VDS_E_PACK_OFFLINE 0x80042444L	Le pack auquel appartient le disque est inaccessible.

Remarques

Utilisez cette méthode pour déterminer la quantité d’espace libre disponible pour la création ou l’extension de volumes. Vous pouvez également utiliser les informations d’extension pour déterminer le nombre de volumes qui occupent le disque. Les types d’extension valides sont : les extensions inconnues, les extensions libres, les extensions de données, les extensions OEM, les extensions ESP, les extensions MSR, les extensions de métadonnées LDM et les extensions inutilisables. Une extension de données contient un lien vers le volume par-dessus.

Si le disque est un disque dynamique, il doit être en ligne. S’il s’agit d’un disque de base ou d’un disque brut, il peut être en ligne ou hors connexion.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vds.h
Bibliothèque	Uuid.lib