Partager via


Méthode IVdsLunNumber ::GetLunNumber (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 le numéro d’unité logique d’un numéro d’unité logique.

Syntaxe

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

Paramètres

[out] pulLunNumber

Adresse d’une variable qui reçoit le numéro d’unité logique. Cette valeur est obligatoire et ne peut pas être NULL.

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 de retour Description
S_OK
La commande s'est correctement terminée.

Notes

Cette méthode retourne le numéro d’unité logique que le fournisseur de matériel VDS a affecté au numéro d’unité logique. Ce numéro identifie le numéro d’unité logique dans le tableau de disques. Il n’est pas identique au « numéro d’unité logique » dans l’adresse SCSI du disque. Chaque numéro d’unité logique du tableau de disques se voit attribuer exactement un numéro d’unité logique.

Cette méthode existe, car l’utilitaire DiskRAID affecte son propre index à chaque LUN lorsqu’il énumère les numéros logiques dans un sous-système. Toutefois, ces index peuvent changer chaque fois que DiskRAID est exécuté, si le fournisseur de matériel énumère les lun dans un ordre différent. Cela peut prêter à confusion pour les utilisateurs finaux. Pour les groupes de disques qui ont leurs propres numéros d’unité logique (attribués par le fournisseur), cette méthode donne à l’appelant la possibilité de mapper les numéros de LUN aux index lun attribués par DiskRAID.

Si un sous-système prend en charge la numérotation lun, il peut indiquer cette prise en charge en définissant l’indicateur VDS_SF_SUPPORTS_LUN_NUMBER dans le membre ulFlags de la structure VDS_SUB_SYSTEM_PROP ou VDS_SUB_SYSTEM_PROP2 . Pour plus d’informations sur cet indicateur, consultez l’énumération VDS_SUB_SYSTEM_FLAG .

Configuration requise

Condition requise Valeur
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

IVdsLunNumber