Méthode IVdsDisk3::GetProperties2 (vds.h)

Article
03/08/2023

[À 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 informations de propriété d’un disque. Cette méthode est identique à la méthode IVdsDisk::GetProperties , sauf qu’elle retourne une structure VDS_DISK_PROP2 au lieu d’une structure de VDS_DISK_PROP .

Syntaxe

HRESULT GetProperties2(
  [out] VDS_DISK_PROP2 *pDiskProperties
);

Paramètres

[out] pDiskProperties

Adresse de la structure VDS_DISK_PROP2 allouée et transmise par l’appelant. VDS alloue de la mémoire pour les chaînes membres pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath et pwszLocationPath . Les appelants doivent libérer les chaînes à 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	Les propriétés ont été retournées avec succès.
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.

Remarques

Dans la structure VDS_DISK_PROP2 retournée dans le paramètre pDiskProperties , le membre pwszDiskAddress est facultatif et peut être NULL si aucune valeur n’est disponible. Les appelants de cette méthode doivent vérifier si ce membre a la valeur NULL.

Pour Hyper-V, le membre pwszLocationPath a la valeur NULL, car le contrôleur virtuel ne retourne pas le chemin d’emplacement.

Configuration requise


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

IVdsDisk3

VDS_DISK_PROP2

Share via