EapHostPeerSetResponseAttributes-Funktion (eappapis.h)
Stellt aktualisierte EAP-Authentifizierungsattribute für EAPHost bereit.
Syntax
DWORD EapHostPeerSetResponseAttributes(
[in] EAP_SESSIONID sessionHandle,
[in] const EapAttributes * const pAttribs,
[out] EapHostPeerResponseAction *pEapOutput,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Ein Zeiger auf eine EAP_SESSIONID Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionId-Parameter in einem vorherigen Aufruf von EapHostPeerBeginSession zurückgegeben.
[in] pAttribs
Ein Zeiger auf eine EapAttributes-Struktur , die ein Array mit neuen EAP-Authentifizierungsantwortattributen enthält, die für den Supplicant auf EAPHost festgelegt werden sollen.
[out] pEapOutput
Ein Zeiger auf einen EapHostPeerResponseAction-Enumerationswert , der den Aktionscode für den nächsten Schritt angibt, den der Supplicant als Antwort ausführen muss.
[out] ppEapError
Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur . Die Adresse sollte vor dem Aufrufen dieser Funktion auf NULL festgelegt werden. Wenn Fehlerdaten verfügbar sind, wird ein Zeiger auf die Adresse einer EAP_ERROR-Struktur empfangen, die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nachdem Sie die Fehlerdaten verwendet haben, geben Sie diesen Arbeitsspeicher frei, indem Sie EapHostPeerFreeEapError aufrufen.
Rückgabewert
Keine
Bemerkungen
Um mit dem nächsten Schritt auf dem Zustandscomputer nach einem Aufruf von EapHostPeerGetResponseAttributes fortzufahren, muss der Supplicant EapHostPeerSetResponseAttributes aufrufen. Der Supplicant muss dies tun, um eine gültige EapAttributes-Struktur zu übergeben, auch wenn der Supplicant die von EapHostPeerGetResponseAttributes zurückgegebenen Attribute nicht verwenden kann.
Das folgende Beispiel zeigt einen EapHostPeerSetResponseAttributes-Aufruf , der ausschließlich zum nächsten Zustand auf dem Zustandscomputer erfolgt.
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);
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eappapis.h |
| Bibliothek | Eappprxy.lib |
| DLL | Eappprxy.dll |