Partager via


Méthode IVdsVolume ::GetProperties (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 les détails de la propriété du volume actif.

Syntaxe

HRESULT GetProperties(
  [out] VDS_VOLUME_PROP *pVolumeProperties
);

Paramètres

[out] pVolumeProperties

Adresse de la structure VDS_VOLUME_PROP 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
S_OK
La commande s'est correctement terminée.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
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.

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

Voir aussi

IVdsVolume

VDS_VOLUME_PROP