Méthode IVdsVolume2 ::GetProperties2 (vds.h)
[À 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 des informations de propriété pour le volume actuel. Cette méthode est identique à la méthode IVdsVolume ::GetProperties , sauf qu’elle retourne une structure de VDS_VOLUME_PROP2 au lieu d’une structure de VDS_VOLUME_PROP .
Syntaxe
HRESULT GetProperties2(
[out] VDS_VOLUME_PROP2 *pVolumeProperties
);
Paramètres
[out] pVolumeProperties
Adresse de la structure VDS_VOLUME_PROP2 allouée et transmise par l’appelant. VDS alloue de la mémoire pour la chaîne de membre pwszName . Les appelants doivent libérer la chaîne à l’aide de la fonction CoTaskMemFree .
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 |
|---|---|
|
La commande s'est correctement terminée. |
|
Certaines propriétés, mais pas toutes, ont été récupérées avec succès. Notez qu’il existe de nombreuses raisons possibles de ne pas récupérer toutes les propriétés, y compris la suppression de l’appareil. |
Remarques
Cette méthode récupère l’identificateur de volume unique d’un volume. La structure qui contient cet identificateur est VDS_VOLUME_PROP2, et non VDS_VOLUME_PROP.
Notez qu’un identificateur de volume unique n’est pas identique à un chemin d’accès GUID de volume. Pour rechercher les chemins d’accès GUID de volume pour un volume, utilisez la méthode IVdsVolumeMF3 ::QueryVolumeGuidPathnames .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vds.h |
| Bibliothèque | Uuid.lib |