EapHostPeerSetResponseAttributes, fonction (eappapis.h)
Fournit des attributs d’authentification EAP mis à jour à EAPHost.
Syntaxe
DWORD EapHostPeerSetResponseAttributes(
[in] EAP_SESSIONID sessionHandle,
[in] const EapAttributes * const pAttribs,
[out] EapHostPeerResponseAction *pEapOutput,
[out] EAP_ERROR **ppEapError
);
Paramètres
[in] sessionHandle
Pointeur vers une structure de EAP_SESSIONID qui contient le handle unique de cette session d’authentification EAP sur le serveur EAPHost. Ce handle est retourné dans le paramètre pSessionId d’un appel précédent à EapHostPeerBeginSession.
[in] pAttribs
Pointeur vers une structure EapAttributes qui contient un tableau de nouveaux attributs de réponse d’authentification EAP à définir pour le demandeur sur EAPHost.
[out] pEapOutput
Pointeur vers une valeur d’énumération EapHostPeerResponseAction qui spécifie le code d’action pour l’étape suivante que le demandeur doit prendre en réponse.
[out] ppEapError
Pointeur vers l’adresse d’une structure EAP_ERROR . L’adresse doit avoir la valeur NULL avant d’appeler cette fonction. Si des données d’erreur sont disponibles, un pointeur vers l’adresse d’une structure de EAP_ERROR qui contient les erreurs générées pendant l’exécution de cet appel de fonction est reçu. Après avoir utilisé les données d’erreur, libérez cette mémoire en appelant EapHostPeerFreeEapError.
Valeur de retour
None
Notes
Pour passer à l’étape suivante de la machine d’état après un appel à EapHostPeerGetResponseAttributes, le demandeur doit appeler EapHostPeerSetResponseAttributes. Le demandeur doit le faire pour passer une structure EapAttributes valide, même si le demandeur ne peut pas utiliser les attributs retournés par EapHostPeerGetResponseAttributes.
L’exemple suivant montre un appel EapHostPeerSetResponseAttributes qui est effectué uniquement pour passer à l’état suivant dans la machine d’état.
EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);
// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};
// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | eappapis.h |
| Bibliothèque | Eappprxy.lib |
| DLL | Eappprxy.dll |