Partager via


Fonction EnumerateVirtualDiskMetadata (virtdisk.h)

Énumère les métadonnées associées à un disque virtuel.

Syntaxe

DWORD EnumerateVirtualDiskMetadata(
  [in]      HANDLE VirtualDiskHandle,
  [in, out] PULONG NumberOfItems,
  [out]     GUID   *Items
);

Paramètres

[in] VirtualDiskHandle

Gérez sur un disque virtuel ouvert.

[in, out] NumberOfItems

Adresse d’un ULONG. En entrée, la valeur indique le nombre d’éléments dans la mémoire tampon pointée par le paramètre Items . Sur la sortie, la valeur contient le nombre d’éléments récupérés. Si la mémoire tampon était trop petite, l’API échoue et retourne ERROR_INSUFFICIENT_BUFFER et l’ULONG contient la taille de mémoire tampon requise.

[out] Items

Adresse d’une mémoire tampon à remplir avec les GUIDreprésentant les métadonnées. La fonction GetVirtualDiskMetadata peut être utilisée pour récupérer les données représentées par chaque GUID.

Valeur retournée

Statut de la demande.

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la mémoire tampon pointée vers le paramètre Items était trop petite, la valeur de retour est ERROR_INSUFFICIENT_BUFFER.

Si la fonction échoue, la valeur de retour est un code d’erreur. Pour plus d’informations, consultez Codes d’erreur système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête virtdisk.h (inclure Windows.h)
Bibliothèque VirtDisk.lib
DLL VirtDisk.dll

Voir aussi

Fonctions VHD