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