EapPeerGetUIContext-Funktion (eapmethodpeerapis.h)

Ruft den Benutzeroberflächenkontext aus der EAP-Methode ab. Auf diese Funktion folgt immer die Funktion EapPeerInvokeInteractiveUI , auf die die EapPeerSetUIContext-Funktion folgt.

Syntax

DWORD EapPeerGetUIContext(
  [in]  EAP_SESSION_HANDLE sessionHandle,
  [out] DWORD              *pdwSizeOfUIContextData,
  [out] BYTE               **ppUIContextData,
  [out] EAP_ERROR          **ppEapError
);

Parameter

[in] sessionHandle

Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionHandle-Parameter in einem vorherigen Aufruf von EapPeerBeginSession zurückgegeben.

[out] pdwSizeOfUIContextData

Ein Zeiger auf einen Wert, der die Größe des in ppUIContextData zurückgegebenen Bytepuffers für Kontextdaten der Benutzeroberfläche angibt.

[out] ppUIContextData

Ein Zeiger auf eine Adresse, die einen Bytepuffer mit den kontextabhängigen Benutzeroberflächenkontextdaten aus EAPHost enthält.

[out] ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapPeerFreeErrorMemory übergeben wird.

Rückgabewert

Keine

Bemerkungen

EapPeerGetUIContext wird von EAPHost aufgerufen, wenn ein vorheriger Aufruf angibt, dass ein Benutzeroberflächenkontext verfügbar ist.

Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die EAP-Methode implementiert werden, die von EAPHost geladen wird, und sie muss streng den in der Dokumentation angegebenen Syntax- und Parametertypen entsprechen.

Anforderungen

Weitere Informationen

EAPHost-Peermethode Run-Time Functions

EapPeerInvokeInteractiveUI

EapPeerSetUIContext