EapHostPeerQueryCredentialInputFields-Funktion (eaphostpeerconfigapis.h)
Ermöglicht dem Benutzer, zu bestimmen, welche Art von Anmeldeinformationen für die Methoden erforderlich sind, um die Authentifizierung in einem Szenario mit einmaligem Anmelden (Single Sign-On, SSO) durchzuführen.
Syntax
DWORD EapHostPeerQueryCredentialInputFields(
[in] HANDLE hUserImpersonationToken,
[in] EAP_METHOD_TYPE eapMethodType,
[in] DWORD dwFlags,
[in] DWORD dwEapConnDataSize,
[in] const BYTE *pbEapConnData,
[out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] hUserImpersonationToken
Ein Handle für das Benutzeridentitätstoken, das in dieser Sitzung verwendet werden soll.
[in] eapMethodType
Eine EAP_METHOD_TYPE Struktur, die die EAP-Methode identifiziert, die der Supplicant verwenden soll.
[in] dwFlags
Eine Kombination von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.
[in] dwEapConnDataSize
Die Größe des in pbEapConnData bereitgestellten Verbindungsdatenpuffers in Bytes.
[in] pbEapConnData
Verbindungsdaten, die für die EAP-Methode verwendet werden.
[out] pEapConfigInputFieldArray
Ein Zeiger auf eine EAP_METHOD_INFO_ARRAY-Struktur für installierte EAP-Methoden. Der Aufrufer sollte die inneren Zeiger mit der Funktion EapHostPeerFreeMemory freigeben, beginnend mit dem innersten Zeiger.
[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
EapHostPeerQueryCredentialInputFields unterstützt einmaliges Anmelden (Single Sign-On, SSO). Diese supplicant-Funktion wie EapHostPeerQueryUserBlobFromCredentialInputFields wird nur in einem SSO-Szenario verwendet.
EapHostPeerQueryCredentialInputFields ruft die Felder ab, die während der Sitzung auf der Benutzeroberfläche angezeigt werden sollen. Die Eingabefelder werden abgerufen, um vom Benutzer eingegebene Daten auf der SSO-Benutzeroberfläche anzuzeigen. Die zurückgegebene EAP_CONFIG_INPUT_FIELD_ARRAY-Struktur enthält Details zur Anzeige der Eingabefelder.
Nach EapHostPeerQueryCredentialInputFields ruft EAPHostPeerQueryUserBlobFromCredentialInputFields auf.
Anforderungen
| 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 |