Partager via


Méthode IVdsHwProvider ::QuerySubSystems (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.]

Retourne une énumération des sous-systèmes gérés par le fournisseur.

Syntaxe

HRESULT QuerySubSystems(
  [out] IEnumVdsObject **ppEnum
);

Paramètres

[out] ppEnum

Adresse d’un pointeur d’interface IEnumVdsObject qui peut être utilisé pour énumérer les sous-systèmes en tant qu’objets de sous-système. Pour plus d’informations, consultez Utilisation d’objets d’énumération. Les appelants doivent libérer l’interface et chacun des objets de sous-système 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
S_OK
Retourne l’énumération des identificateurs de sous-système. Si le fournisseur ne gère aucun sous-système, l’énumération est vide.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Cette valeur de retour signale 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_STATUS_FAILED
0x80042431L
Le fournisseur est dans un état d’échec et n’est pas en mesure d’effectuer l’opération demandée.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Une autre opération est en cours ; cette opération ne peut pas se poursuivre tant que la ou les opérations précédentes ne sont pas terminées.
VDS_E_INITIALIZE_NOT_CALLED
0x80042402L
La méthode d’initialisation n’a pas été appelée.

Remarques

L’objet retourné énumère tous les sous-systèmes actuellement connectés au réseau. Utilisez la méthode IVdsHwProvider ::Reenumerate pour découvrir de nouveaux sous-systèmes. Utilisez la méthode IVdsHwProvider ::Refresh pour actualiser les données du fournisseur mis en cache interne pour les sous-systèmes existants.

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

Voir aussi

IEnumVdsObject

IVdsHwProvider

IVdsHwProvider ::Réenumerate

IVdsHwProvider ::Refresh