EapPeerQueryUIBlobFromInteractiveUIInputFields-Funktion (eapmethodpeerapis.h)

Die Funktion EapPeerQueryUIBlobFromInteractiveUIInputFields konvertiert Benutzerinformationen in ein Benutzerblob, das von EAPHost-Laufzeitfunktionen verwendet werden kann.

Syntax

DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [out]     BYTE                          **ppDataFromInteractiveUI,
  [out]     EAP_ERROR                     **ppEapError,
  [in, out] LPVOID                        *ppvReserved
);

Parameter

[in] dwVersion

Die Versionsnummer der API. Muss auf 0 (null) festgelegt werden.

[in] dwFlags

Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] dwSizeofUIContextData

Die Größe der Kontextdaten im pUIContextData-Parameter in Bytes.

[in] pUIContextData

Ein Zeiger auf ein BLOB, das Benutzeroberflächenkontextdaten enthält, die als innere Zeiger auf Felddaten dargestellt werden. Der Supplicant hat diese inneren Zeiger von EAPHost-Laufzeitfunktionen abgerufen.

[in] pEapInteractiveUIData

Zeiger, der eine EAP_INTERACTIVE_UI_DATA-Struktur empfängt, die Konfigurationsinformationen für interaktive Benutzeroberflächenkomponenten enthält, die auf einem EAP-Supplicant ausgelöst werden.

[out] pdwSizeOfDataFromInteractiveUI

Ein Zeiger auf ein DWORD, der die Größe des Puffers angibt, auf den der ppDataFromInteractiveUI-Parameter in Bytes verweist. Wenn dieser Wert nicht auf 0 festgelegt ist, muss im Parameter ppDataFromInteractiveUI ein Zeiger auf einen Puffer der in diesem Parameter angegebenen Größe angegeben werden.

[out] ppDataFromInteractiveUI

Ein Zeiger, der ein Blob für Anmeldeinformationen empfängt, das bei der Authentifizierung verwendet werden kann. Der Aufrufer sollte die inneren Zeiger mit der Funktion EapPeerFreeMemory freigeben, beginnend am innersten Zeiger. Wenn für diesen Parameter ein Wert ungleich NULL angegeben wird, d. h., dass ein vorhandenes Datenblob an ihn übergeben wird, wird das angegebene Datenblob aktualisiert und in diesem Parameter zurückgegeben.

[out] ppEapError

Ein Zeiger auf die Adresse einer 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 EapPeerFreeErrorMemory freigegeben werden.

[in, out] ppvReserved

Für die zukünftige Verwendung reserviert. Dieser Parameter muss auf 0 festgelegt werden.

Rückgabewert

Keine

Bemerkungen

Aufrufsequenz der Peermethoden-API.

Anforderungen

Weitere Informationen

EAPHost Supplicant-Konfigurationsfunktionen

SSO und PLAP