EapHostPeerInvokeInteractiveUI-Funktion (eaphostpeerconfigapis.h)

Löst eine interaktive Benutzeroberfläche aus, die zum Abrufen von Anmeldeinformationen vom Benutzer verwendet wird. Diese Funktion kann beispielsweise verwendet werden, um eine Benutzeroberfläche auszulösen, die Anmeldeinformationen von einem intelligenten Karte abruft und den Benutzer zur Eingabe der entsprechenden PIN auffordert.

EapHostPeerInvokeInteractiveUI muss für Threads aufgerufen werden, die COM für Single Threaded Apartment initialisiert haben. Dies kann durch Aufrufen der COM-API CoInitialize erreicht werden. wenn der Supplicant mit dem STA-Thread CoUninitialize beendet wurde, muss vor dem Beenden aufgerufen werden.

Syntax

DWORD EapHostPeerInvokeInteractiveUI(
  [in]  HWND       hwndParent,
  [in]  DWORD      dwSizeofUIContextData,
  [in]  const BYTE *pUIContextData,
  [out] DWORD      *pdwSizeOfDataFromInteractiveUI,
  [out] BYTE       **ppDataFromInteractiveUI,
  [out] EAP_ERROR  **ppEapError
);

Parameter

[in] hwndParent

Das Handle des übergeordneten Fensters, unter dem das Konfigurationsdialogfeld angezeigt wird.

[in] dwSizeofUIContextData

Die Größe des Puffers in Bytes, auf den der Parameter pUIContextData verweist.

[in] pUIContextData

Ein Zeiger auf einen Puffer, der die kontextabhängigen Benutzeroberflächenkontextdaten aus EAPHost enthält. Die Kontextdaten werden von EapHostPeerGetUIContext zurückgegeben. Der Puffer hat die Größe dwSizeOfUIContextData.

[out] pdwSizeOfDataFromInteractiveUI

Ein Zeiger auf ein DWORD, das die Größe des Puffers in Bytes darstellt, auf den der ppDataFromInteractiveUI-Parameter verweist.

[out] ppDataFromInteractiveUI

Ein Zeiger auf einen Zeiger auf einen Bytepuffer, der Daten aus der interaktiven Benutzeroberfläche enthält, die für die Authentifizierung erforderlich sind. Der Parameter ppDataFromInteractiveUI sollte als IN-Parameter pUIContext an EapHostPeerSetUIContext übergeben werden. Nach der Nutzung der Daten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden. Der Puffer hat die Größe pdwSizeofDataFromInteractiveUI.

[out] ppEapError

Ein Zeiger auf einen Zeiger auf eine EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.

Rückgabewert

Keine

Bemerkungen

Der Supplicant sollte aufrufen, EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED zurückgegeben wird. Der Supplicant sollte auf das herkömmliche Modell des Aufrufens der interaktiven Benutzeroberfläche der Methode zurückgreifen, indem EapHostPeerInvokeInteractiveUI aufgerufen wird.

Wenn der Aufruf erfolgt, löst EapHostPeerInvokeInteractiveUI die Benutzeroberfläche für die EAP-Methode aus, nachdem der supplicant EapHostPeerGetUIContext aufgerufen hat. Dies tritt auf, wenn ein Aufruf von EapHostPeerProcessReceivedPacket den EapHostPeerResponseInvokeUi-Aktionscode zurückgibt. EapHostPeerGetUIContext gibt ui-Kontext zurück, den der Supplicant dann an EapHostPeerInvokeInteractiveUI übergibt, um die Benutzeroberfläche auszulösen.

Anforderungen

Weitere Informationen

EAPHost Supplicant-Konfigurationsfunktionen

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext