Méthode IVdsControllerPort::GetProperties (vdshwprv.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.]
Récupère les propriétés d’un port de contrôleur.
Syntaxe
HRESULT GetProperties(
[out] VDS_PORT_PROP *pPortProp
);
Paramètres
[out] pPortProp
Adresse d’un membre de la structure VDS_PORT_PROP allouée et passée par l’appelant. VDS alloue de la mémoire aux chaînes 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 |
|---|---|
|
Les propriétés ont été récupérées avec succès. |
|
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. |
|
Le cache du fournisseur est endommagé. Cela indique un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur les appareils attachés. L’appelant peut utiliser la méthode IVdsHwProvider::Reenumerate suivie de la méthode IVdsHwProvider::Refresh pour restaurer le cache. |
|
L’objet port du contrôleur n’est plus présent. |
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vdshwprv.h |