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

Weitere Informationen

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO und PLAP