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

Weitere Informationen

EAPHost Supplicant-Laufzeitfunktionen

EapHostPeerGetResponseAttributes