EapPeerQueryCredentialInputFields-Funktion (eapmethodpeerapis.h)
Definiert die Implementierung einer EAP-methodenspezifischen Funktion, die die Eingabefelder für EAP-Anmeldeinformationen für einmaliges Anmelden (Single Sign-On, SSO) für eine EAP-Methode abruft.
Syntax
DWORD EapPeerQueryCredentialInputFields(
[in] HANDLE hUserImpersonationToken,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwFlags,
[in] DWORD dwEapConnDataSize,
[in] BYTE *pbEapConnData,
[out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] hUserImpersonationToken
Ein Identitätswechseltoken für den Benutzer, dessen Anmeldeinformationen angefordert und abgerufen werden sollen.
[in] eapMethodType
Eine EAP_METHOD_TYPE Struktur, die Anbieter- und Autoreninformationen zur EAP-Methode enthält, die für die Authentifizierung der Verbindung verwendet wird.
[in] dwFlags
Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] dwEapConnDataSize
Die Größe der Bytedaten für die EAP-SSO-Konfiguration, auf die pbEapConnData in Bytes verweist.
[in] pbEapConnData
Ein Zeiger auf einen undurchsichtigen Bytepuffer, der das EAP-Konfigurationsdatenblob enthält.
[out] pEapConfigFieldsArray
Ein Zeiger auf eine EAP_CONFIG_INPUT_FIELD_ARRAY Struktur, die die Eingabefelder enthält, die dem supplicant-Benutzer angezeigt werden sollen. Die pwszData-Felder in den einzelnen EAP_CONFIG_INPUT_FIELD_DATA-Elementen werden mit NULL initialisiert.
[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 freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapPeerFreeErrorMemory übergeben wird.
Rückgabewert
Keine
Bemerkungen
EapPeerQueryCredentialInputFields unterstützt einmaliges Anmelden. Diese Peermethodenfunktion wie EapPeerQueryUserBlobFromCredentialInputFields wird nur in einem SSO-Szenario verwendet.
Die EAP-methodenspezifische Implementierung dieser Funktion wird von EAPHost aufgerufen, wenn eine supplicant-Anwendung EapHostPeerQueryCredentialInputFields aufruft. Der Implementierer dieser Funktion ist dafür verantwortlich, sicherzustellen, dass die von dieser Funktion zurückgegebene EAP_CONFIG_INPUT_FIELD_ARRAY Eingabefelddefinitionen für jeden Teil von Anmeldeinformationen enthält, die die EAP-Methoden vom supplicant-Benutzer anfordern.
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 |