EapHostPeerGetMethodProperties-Funktion (eaphostpeerconfigapis.h)
Die EapHostPeerGetMethodProperties-Funktion wird verwendet, um die Eigenschaften einer EAP-Methode unter Berücksichtigung der Verbindungs- und Benutzerdaten abzurufen.
Syntax
DWORD EapHostPeerGetMethodProperties(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] EAP_METHOD_TYPE eapMethodType,
[in] HANDLE hUserImpersonationToken,
[in] DWORD dwEapConnDataSize,
[in] const BYTE *pbEapConnData,
[in] DWORD dwUserDataSize,
[in] const BYTE *pbUserData,
[out] EAP_METHOD_PROPERTY_ARRAY *pMethodPropertyArray,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] dwVersion
Die Versionsnummer der API. Legen Sie diesen Parameter auf 0 fest.
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] eapMethodType
Eine EAP_METHOD_TYPE-Struktur , die die EAP-Methode angibt, die der Supplicant verwenden soll.
[in] hUserImpersonationToken
Ein Handle für das Benutzeridentitätstoken, das in dieser Sitzung verwendet werden soll.
[in] dwEapConnDataSize
Die Größe des in pbEapConnData bereitgestellten Verbindungsdatenpuffers in Bytes.
[in] pbEapConnData
Verbindungsdaten, die für die EAP-Methode verwendet werden. Wenn sie auf NULL festgelegt ist, wird die statische Eigenschaft der Methode zurückgegeben, wie sie in der Registrierung konfiguriert ist.
[in] dwUserDataSize
Die Größe des in pbUserData bereitgestellten Benutzerdatenpuffers in Bytes.
[in] pbUserData
Ein Zeiger auf einen Bytepuffer, der das undurchsichtige Benutzerdatenblob enthält. Dieser Parameter kann NULL sein.
[out] pMethodPropertyArray
Ein Zeiger auf das Array der Methodeneigenschaften EAP_METHOD_PROPERTY_ARRAY. Der Aufrufer sollte die inneren Zeiger mit EapHostPeerFreeMemory ab dem innersten Zeiger freigeben. Der Aufrufer sollte einen empvString-Wert nur freigeben, wenn der Typ empvtString ist.
[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 werden. Nach dem Verbrauch der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger an EapHostPeerFreeErrorMemory übergeben wird.
Rückgabewert
Keine
Bemerkungen
EapHostPeerGetMethodProperties ermöglicht es dem Benutzer, die Eigenschaften einer EAP-Methode über die EAPHost-Supplicant-Schnittstelle abzurufen. Die von dieser API zurückgegebenen Eigenschaften unterscheiden sich möglicherweise von eigenschaften, die von der EapHostPeerGetMethods-Funktion zurückgegeben werden. Die EapHostPeerGetMethodProperties-Funktion gibt die Eigenschaften einer EAP-Methode für eine bestimmte Verbindung und Benutzerdaten zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eaphostpeerconfigapis.h |
| Bibliothek | Eappcfg.lib |
| DLL | Eappcfg.dll |