Méthode IVdsIscsiTarget ::GetConnectedInitiators (vds.h)

Article
03/06/2024

[À 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 la liste des noms iSCSI des initiateurs actuellement connectés à la cible.

Syntaxe

HRESULT GetConnectedInitiators(
  [out] LPWSTR **pppwszInitiatorList,
  [out] LONG   *plNumberOfInitiators
);

Paramètres

[out] pppwszInitiatorList

Adresse d’une variable qui reçoit un tableau de chaînes contenant les noms iSCSI des initiateurs actuellement connectés à la cible. Les appelants doivent libérer chaque chaîne de ce tableau, ainsi que le tableau lui-même, à l’aide de la fonction CoTaskMemFree .

[out] plNumberOfInitiators

Pointeur vers le nombre de chaînes retournées dans pppwszInitiatorList.

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	La liste des initiateurs connectés a été retournée avec succès.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Une autre opération est en cours ; cette opération ne peut pas se poursuivre tant que les opérations précédentes ne sont pas terminées.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Le cache du fournisseur est endommagé. Cela indique un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur les appareils attachés. L’appelant peut utiliser la méthode IVdsHwProvider ::Reenumerate suivie de la méthode IVdsHwProvider ::Refresh pour restaurer le cache.
VDS_E_OBJECT_DELETED 0x8004240BL	L’objet cible n’est plus présent.

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

Voir aussi

IVdsIscsiTarget

Partager via