IVdsServiceIscsi::SetInitiatorSharedSecret, méthode (vds.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.]
Définit le secret partagé CHAP de l’initiateur utilisé pour l’authentification CHAP mutuelle lorsque l’initiateur authentifie la cible.
Syntaxe
HRESULT SetInitiatorSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
[in] VDS_OBJECT_ID targetId
);
Paramètres
[in] pInitiatorSharedSecret
Adresse d’une structure de VDS_ISCSI_SHARED_SECRET qui contient le secret partagé. Si le membre pSharedSecret est NULL et que ulSharedSecretSize est égal à zéro, la méthode SetInitiatorSharedSecret efface tout secret existant. Si ce paramètre a la valeur NULL et que le paramètre targetId n’est pas GUID_NULL, SetInitiatorSharedSecret efface l’association entre l’initiateur et la cible.
[in] targetId
VDS_OBJECT_ID de la cible. Ce paramètre est défini sur GUID_NULL si le secret partagé ne doit pas être spécifique à la cible.
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 |
|---|---|
|
Le secret partagé a été défini avec succès. |
|
VDS n’a pas pu s’initialiser. 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. |
|
Le service initiateur ne prend pas en charge la définition de secrets partagés spécifiques à la cible. |
Remarques
Un initiateur peut prendre en charge la définition d’un secret partagé CHAP différent pour chaque cible.
Il n’existe aucun moyen de déterminer par programmation si un initiateur prend en charge les secrets spécifiques à la cible. Si l’appel à SetInitiatorSharedSecret retourne VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, appelez à nouveau la méthode en définissant le paramètre targetId sur GUID_NULL.
L’initiateur de logiciel Microsoft iSCSI ne prend pas en charge la définition de secrets spécifiques à la cible.
Configuration requise
| 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::RememberInitiatorSharedSecret
IVdsIscsiTarget::SetSharedSecret