Méthode IVdsServiceHba ::QueryHbaPorts (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.]
Renvoie un objet d’énumération IEnumVdsObject contenant une liste des ports HBA connus pour VDS sur le système local.
Syntaxe
HRESULT QueryHbaPorts(
[out] IEnumVdsObject **ppEnum
);
Paramètres
[out] ppEnum
Adresse d’un pointeur d’interface IEnumVdsObject qui peut être utilisé pour énumérer les ports HBA en tant qu’objets de port HBA. Pour plus d’informations, consultez Utilisation d’objets d’énumération. Les appelants doivent libérer l’interface et chacun des objets de port HBA lorsqu’ils ne sont plus nécessaires en appelant la méthode IUnknown ::Release .
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 |
|---|---|
|
L’énumération des ports HBA a été retournée avec succès. Si le système local n’a pas de ports HBA, l’énumération est vide. |
|
Échec de l’initialisation de VDS. Si une application appelle cette méthode avant la fin de l’initialisation du service VDS, la méthode est bloquée jusqu’à ce que l’initialisation soit terminée. Si l’initialisation échoue, cette erreur est retournée. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | vds.h |