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