EapPeerQueryUserBlobFromCredentialInputFields-Funktion (eapmethodpeerapis.h)

Die EapPeerQueryUserBlobFromCredentialInputFields-Funktion definiert die Implementierung einer EAP-Methodenfunktion, die die Benutzerblobdaten abruft, die auf einer interaktiven Benutzeroberfläche für einmaliges Anmelden (Single Sign-On, SSO) bereitgestellt werden, die auf dem Supplicant ausgelöst wird.

Syntax

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      BYTE                               *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [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 von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] dwEapConnDataSize

Die Größe der EAP-SSO-Konfigurationsdaten, auf die von pbEapConnData in Bytes verwiesen wird.

[in] pbEapConnData

Ein Zeiger auf einen undurchsichtigen Bytepuffer, der das EAP SSO-Konfigurationsdatenblob enthält.

[in] pEapConfigInputFieldArray

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.

[in, out] pdwUserBlobSize

Ein Zeiger auf einen Puffer, der die Größe des undurchsichtigen Benutzerkonfigurationsdaten-BLOB in ppUserBlob in Bytes enthält.

[in, out] ppbUserBlob

Ein Zeiger, der das undurchsichtige Benutzerdatenblob enthält.

[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

EapPeerQueryUserBlobFromCredentialInputFields unterstützt einmaliges Anmelden (Single Sign-On, SSO). Diese Peermethodenfunktion wie EapPeerQueryCredentialInputFields wird nur in einem SSO-Szenario verwendet.

Nach EapPeerQueryUserBlobFromCredentialInputFields ruft EAPHost EapPeerBeginSession auf. Das Supplicant verwendet das EAP_FLAG_PRE_LOGON-Flag in EapHostPeerBeginSession , um anzugeben, dass EAPHost einmaliges Anmelden bereitstellen soll.

Anforderungen

Weitere Informationen

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO und PLAP