EapHostPeerSetUIContext-Funktion (eappapis.h)

Stellt einen neuen oder aktualisierten Benutzeroberflächenkontext für die EAP-Peermethode bereit, die in EAPHost geladen wird, nachdem die Benutzeroberfläche ausgelöst wurde. Weitere Informationen zum Erhöhen der Benutzeroberfläche finden Sie unter EapHostPeerGetUIContext.

EapHostPeerSetUIContext legt die Benutzeroberflächenkontextdaten fest, die von einem Aufruf an EapHostPeerInvokeInteractiveUI empfangen wurden.

Syntax

DWORD EapHostPeerSetUIContext(
  [in]  EAP_SESSIONID             sessionHandle,
  [in]  DWORD                     dwSizeOfUIContextData,
  [in]  const BYTE * const        pUIContextData,
  [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] dwSizeOfUIContextData

Die Größe des in pUIContextData bereitgestellten Benutzeroberflächenkontextdatenpuffers in Bytes.

[in] pUIContextData

Ein Zeiger auf einen Bytepuffer, der die neuen supplicant UI-Kontextdaten enthält, die auf EAPHost festgelegt werden sollen. Die Daten werden vom Out-Parameter EapHostPeerInvokeInteractiveUI zurückgegeben .

[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

Anforderungen

Weitere Informationen

EAPHost Supplicant Laufzeitfunktionen

EapHostPeerGetUIContext

EapHostPeerInvokeInteractiveUI