GetVirtualDiskMetadata, fonction (virtdisk.h)
Récupère les métadonnées spécifiées du disque virtuel.
Syntaxe
DWORD GetVirtualDiskMetadata(
[in] HANDLE VirtualDiskHandle,
[in] const GUID *Item,
[in, out] PULONG MetaDataSize,
[out] PVOID MetaData
);
Paramètres
[in] VirtualDiskHandle
Gérez sur un disque virtuel ouvert.
[in] Item
Adresse d’un GUID identifiant les métadonnées à récupérer.
[in, out] MetaDataSize
Adresse d’un ULONG. Lors de l’entrée, la valeur indique la taille, en octets, de la mémoire tampon pointée par le paramètre MetaData . Lors de la sortie, la valeur contient la taille, en octets, des métadonnées récupérées. Si la mémoire tampon était trop petite, l’API échoue et retourne ERROR_INSUFFICIENT_BUFFER, en plaçant la taille requise dans l’ULONG et la mémoire tampon contient le début des métadonnées.
[out] MetaData
Adresse de la mémoire tampon où les métadonnées doivent être stockées.
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 par 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 |