EapHostPeerGetUIContext-Funktion (eappapis.h)

Ruft den Benutzeroberflächenkontext für das Supplicant von EAPHost ab, wenn die Benutzeroberfläche ausgelöst werden soll.

Auf EAPHostPeerGetUIContext folgen immer die folgenden Funktionen.

• EapHostPeerInvokeInteractiveUI und
• EapHostPeerSetUIContext

Syntax

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [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.

[out] pdwSizeOfUIContextData

Ein Zeiger auf einen Wert, der die Größe des in ppUIContextData zurückgegebenen Benutzeroberflächenkontextdatenpuffers in Bytes angibt.

[out] ppUIContextData

Ein Zeiger auf einen Zeiger auf einen Puffer, der die kontextabhängigen Benutzeroberflächendaten aus EAPHost enthält. Die Adresse, auf die dieser Parameter verweist, wird als IN-Parameter pUIContextData an EapHostPeerInvokeInteractiveUI übergeben.

[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

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext