Méthode IVdsSubSystem2 ::GetProperties2 (vdshwprv.h)

  • Article

[À 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 propriétés d’un sous-système. Cette méthode est identique à la méthode IVdsSubSystem ::GetProperties , sauf qu’elle retourne une structure VDS_SUB_SYSTEM_PROP2 au lieu d’une structure VDS_SUB_SYSTEM_PROP .

Syntaxe

HRESULT GetProperties2(
  [out] VDS_SUB_SYSTEM_PROP2 *pSubSystemProp2
);

Paramètres

[out] pSubSystemProp2

Adresse de la structure VDS_SUB_SYSTEM_PROP2 allouée et passée par l’appelant. VDS alloue de la mémoire pour les chaînes de membres pwszFriendlyName et pwszIdentification . 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
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 pour ne pas récupérer toutes les propriétés, y compris la suppression de l’appareil.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Il existe un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur le tableau. Utilisez la méthode IVdsHwProvider ::Reenumerate suivie de la méthode IVdsHwProvider ::Refresh pour restaurer le cache.
VDS_E_OBJECT_DELETED
0x8004240BL
 L’objet de sous-système n’est plus présent.

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 vdshwprv.h
Bibliothèque Uuid.lib

Voir aussi

IVdsSubSystem2