EapHostPeerQueryUIBlobFromInteractiveUIInputFields-Funktion (eaphostpeerconfigapis.h)

Artikel
02/28/2024

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

Syntax

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

Parameter

[in] dwVersion

Die Versionsnummer der API.

Wert	Bedeutung
EAPHOST_PEER_API_VERSION 1	Die Version der EAPHost-Peer-APIs.

[in] dwFlags

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

[in] dwSizeofUIContextData

Die Größe der Kontextdaten in pUIContextData in Bytes.

[in] pUIContextData

Zeiger auf ein BLOB, das Benutzeroberflächenkontextdaten enthält, dargestellt als innere Zeiger auf Felddaten. Diese inneren Zeiger müssen freigegeben werden, indem sie an EapHostPeerFreeMemory übergeben werden, beginnend mit dem innersten Zeiger.

[in] pEapInteractiveUIData

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

[in, out] pdwSizeOfDataFromInteractiveUI

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

[in, out] ppDataFromInteractiveUI

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 EapHostPeerFreeMemory 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. Wenn ein BLOB-Wert ungleich NULL angegeben wird, sollte die LocalAlloc-Funktion verwendet werden.

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

[in, out] ppvReserved

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

Rückgabewert

Keine

Bemerkungen

Supplicant-API-Aufrufsequenz.

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	eaphostpeerconfigapis.h
Bibliothek	Eappcfg.lib
DLL	Eappcfg.dll

Weitere Informationen

EAPHost Supplicant-Konfigurationsfunktionen

SSO und PLAP

Freigeben über