EapPeerSetUIContext-Funktion (eapmethodpeerapis.h)
Stellt einen Benutzeroberflächenkontext für die EAP-Methode bereit. Diese Funktion wird aufgerufen, nachdem die Benutzeroberfläche über die EapPeerGetUIContext-Funktion ausgelöst wurde.
Syntax
DWORD EapPeerSetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] DWORD dwSizeOfUIContextData,
[in] const BYTE *pUIContextData,
[in] EapPeerMethodOutput *pEapOutput,
[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.
[in] dwSizeOfUIContextData
Ein Zeiger auf einen Wert, der die Größe des in pUIContextData bereitgestellten Ui-Kontextdatenbyte-Puffers angibt.
[in] pUIContextData
Ein Zeiger auf eine Adresse, die einen Bytepuffer mit den neuen supplicant UI-Kontextdaten enthält, die auf EAPHost festgelegt werden sollen.
[in] pEapOutput
Ein Zeiger auf eine EapPeerMethodOutput-Struktur , die die Ausgabe des Paketprozessvorgangs 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 dem Verbrauch der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger an EapPeerFreeErrorMemory übergeben wird.
Rückgabewert
Keine
Bemerkungen
Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodpeerapis.h |