Méthode IVdsLunIscsi ::AssociateTargets (vdshwprv.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.]

Associe des lun aux cibles iSCSI du sous-système.

Syntaxe

HRESULT AssociateTargets(
  [in] VDS_OBJECT_ID *pTargetIdArray,
  [in] LONG          lNumberOfTargets
);

Paramètres

[in] pTargetIdArray

Pointeur vers un tableau de types de données VDS_OBJECT_ID cibles. Le fournisseur associe ces cibles iSCSI au numéro d’unité logique. Ce tableau inclut des cibles déjà associées au numéro d’unité logique qui doivent le rester.

[in] lNumberOfTargets

Nombre de cibles spécifiées dans le paramètre pTargetArray .

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
 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_DELETED
0x8004240BL
 L’objet LUN n’est plus présent.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Le numéro d’unité logique est en état d’échec et ne peut pas 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 continuer tant que l’opération ou les opérations précédentes ne sont pas terminées.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Peut être retourné à partir de n’importe quelle méthode qui prend une constante VDS_OBJECT_ID . Cette valeur de retour indique que l’identificateur ne fait pas référence à un objet existant.
VDS_E_NOT_SUPPORTED
0x80042400L
 Cette opération ou cette combinaison de paramètres n’est pas prise en charge par ce fournisseur.

Remarques

La plupart des sous-systèmes implémentent une seule cible associée par unité logique, mais certains autorisent plusieurs cibles associées.

Utilisez la méthode IVdsLunIscsi ::QueryAssociatedTargets pour interroger les associations cibles. Utilisez la méthode IVdsIscsiTarget ::QueryAssociatedLuns pour interroger les lun associés à une cible.

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 vdshwprv.h
Composant redistribuable VDS 1.1

Voir aussi

IVdsLunIscsi

IVdsLunIscsi ::QueryAssociatedTargets