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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour