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
| 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 |