Partager via


Méthode IVdsSubSystem2::GetDrive2 (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 le lecteur spécifié. Cette méthode est identique à la méthode IVdsSubSystem::GetDrive , sauf qu’elle inclut le numéro de boîtier en tant que paramètre.

Syntaxe

HRESULT GetDrive2(
  [in]  SHORT     sBusNumber,
  [in]  SHORT     sSlotNumber,
  [in]  ULONG     ulEnclosureNumber,
  [out] IVdsDrive **ppDrive
);

Paramètres

[in] sBusNumber

Numéro du bus auquel le lecteur est connecté.

[in] sSlotNumber

Numéro de l’emplacement occupé par le lecteur.

[in] ulEnclosureNumber

Numéro du boîtier qui contient le lecteur. Ce paramètre correspond au membre ulEnclosureNumber de la structure VDS_DRIVE_PROP2 .

[out] ppDrive

Adresse d’un pointeur d’interface IVdsDrive . Les appelants doivent libérer l’interface.

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_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.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Le sous-système 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.

Configuration requise

   
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

IVdsDrive2

IVdsHwProvider::Réenumerate

IVdsHwProvider::Refresh

IVdsSubSystem2

IVdsSubSystem::GetDrive

IVdsSubSystem::QueryDrives