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
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | eapmethodpeerapis.h |