Méthode IVdsService ::QueryProviders (vds.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 un objet d’énumération contenant une liste des fournisseurs matériels et logiciels connus pour VDS.

Syntaxe

HRESULT QueryProviders(
  [in]  DWORD          masks,
  [out] IEnumVdsObject **ppEnum
);

Paramètres

[in] masks

Masque de fournisseur énuméré par VDS_QUERY_PROVIDER_FLAG. Les appelants peuvent spécifier un masque de fournisseur de logiciels, un masque de fournisseur de matériel ou les deux.

[out] ppEnum

Adresse d’un pointeur d’interface IEnumVdsObject qui peut être utilisée pour énumérer les fournisseurs en tant qu’objets de fournisseur. Pour plus d’informations, consultez Utilisation d’objets d’énumération. Les appelants doivent libérer l’interface et chacun des objets du fournisseur 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
 L’énumération est retournée avec succès.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Échec de l’initialisation de VDS. Si une application appelle cette méthode avant la fin de l’initialisation du service, la méthode est bloquée jusqu’à la fin de l’initialisation. Si l’initialisation échoue, cette erreur est retournée.

Remarques

Pour déterminer le type de fournisseur pour les fournisseurs de matériel, appelez la méthode IVdsHwProviderType2 ::GetProviderType2 ou la méthode IVdsHwProviderType ::GetProviderType pour chaque objet fournisseur.

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

Voir aussi

IEnumVdsObject

IVdsService

VDS_HWPROVIDER_TYPE

VDS_QUERY_PROVIDER_FLAG