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

Weitere Informationen

EAPHost Supplicant-Konfigurationsfunktionen

SSO und PLAP