EapPeerGetConfigBlobAndUserBlob-Funktion (eapmethodpeerapis.h)
Die EapPeerGetConfigBlobAndUserBlob-Methode ermöglicht es EAP-Methodenentwicklern, die verschiedenen Verbindungseigenschaften und Benutzereigenschaften bereitzustellen, die von der -Methode unterstützt werden. EAPHost ruft diese Funktion auf, um die Verbindungseigenschaft und die Benutzereigenschaft der EAP-Methode zu erstellen.
Syntax
DWORD EapPeerGetConfigBlobAndUserBlob(
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] EapCredential eapCredential,
[out] DWORD *pdwConfigBlobSize,
[out] BYTE **ppConfigBlob,
[out] DWORD *pdwUserBlobSize,
[out] BYTE **ppUserBlob,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] eapMethodType
Die EAP_METHOD_TYPE-Struktur , die Anbieter- und Autoreninformationen zur EAP-Methode enthält, die für die Authentifizierung der Verbindung verwendet wird.
[in] eapCredential
Eine EapCredential-Struktur , die den Anmeldeinformationstyp und die entsprechenden Anmeldeinformationen enthält.
[out] pdwConfigBlobSize
Empfängt einen Zeiger auf die Größe des ppConfigBlob-Parameters in Bytes.
[out] ppConfigBlob
Empfängt einen Zeiger auf einen Zeiger, der einen Bytepuffer mit konfigurierten Verbindungsdaten enthält.
[out] pdwUserBlobSize
Empfängt einen Zeiger auf die Größe des ppUserBlob-Parameters in Bytes.
[out] ppUserBlob
Empfängt einen Zeiger auf einen Zeiger, der einen Bytepuffer mit den Benutzerdaten der Methoden 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 durch Aufrufen von EapPeerFreeErrorMemory freigegeben werden.
Rückgabewert
Diese Funktion sollte ERROR_SUCCESS zurückgeben, wenn sie die richtige Verbindung und das richtige Benutzerblob generieren kann. In allen anderen Fällen wird der entsprechende Windows-Fehler zurückgegeben.
Hinweise
Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodpeerapis.h |
| DLL | Eappcfg.dll |