Méthode IVdsServiceIscsi::RememberTargetSharedSecret (vds.h)

Article
03/08/2023

[À 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.]

Communique le secret partagé CHAP d’une cible au service initiateur. Ce secret partagé est utilisé lors de la connexion cible lorsque la cible authentifie l’initiateur.

Syntaxe

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

Paramètres

[in] targetId

Le VDS_OBJECT_ID de la cible qui a le secret partagé spécifié. Ce paramètre est obligatoire et ne peut pas être GUID_NULL.

[in] pTargetSharedSecret

Adresse d’une structure VDS_ISCSI_SHARED_SECRET qui contient le secret partagé CHAP.

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	Le secret partagé a été mémorisé avec succès.
VDS_E_INITIALIZED_FAILED 0x80042401L	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.

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

IVdsServiceIscsi

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET

Partager via