EapHostPeerQueryUserBlobFromCredentialInputFields-Funktion (eaphostpeerconfigapis.h)

Die Funktion EapHostPeerQueryUserBlobFromCredentialInputFields ruft ein Anmeldeinformationsblob ab, das zum Starten der Authentifizierung von Benutzereingaben verwendet werden kann, die von der Benutzeroberfläche für einmaliges Anmelden (Single Sign-On, SSO) empfangen werden.

Syntax

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const 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 Handle für das Benutzeridentitätswechseltoken, das in dieser Sitzung verwendet werden soll.

[in] eapMethodType

Eine EAP_METHOD_TYPE Struktur, die den Typ der EAP-Authentifizierung angibt, die für diese Sitzung verwendet werden soll.

[in] dwFlags

Eine Kombination aus EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] dwEapConnDataSize

Die Größe des in pConnectionData bereitgestellten Verbindungsdatenpuffers in Bytes.

[in] pbEapConnData

Verbindungsdaten, die für die EAP-Methode verwendet werden.

[in] pEapConfigInputFieldArray

Ein Zeiger auf eine EAP_CONFIG_INPUT_FIELD_ARRAY Struktur, die die Eingabefelddaten der Benutzeroberfläche enthält. Der Aufrufer sollte die inneren Zeiger mit der Funktion EapHostPeerFreeMemory freigeben, beginnend am innersten Zeiger.

[in, out] pdwUserBlobSize

Ein Zeiger auf ein DWORD, der die Größe des Puffers in Byte angibt, auf den ppbUserBlob verweist. Wenn dieser Wert nicht auf null festgelegt ist, muss für ppbUserBlob ein Zeiger auf einen Puffer der in diesem Parameter angegebenen Größe angegeben werden.

[in, out] ppbUserBlob

Ein Zeiger auf das Anmeldeinformationsblob, das bei der Authentifizierung verwendet werden kann. Der Arbeitsspeicher muss durch Aufrufen von EapHostPeerFreeMemory freigegeben werden. Wenn für diesen Parameter ein Wert ungleich NULL angegeben wird (d. h., dass ein vorhandenes Datenblob an ihn übergeben wird), wird das angegebene Datenblob aktualisiert und in diesem Parameter zurückgegeben. Wenn ein BLOB-Wert ungleich NULL angegeben wird, sollte die LocalAlloc-Funktion verwendet werden.

[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 wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.

Rückgabewert

Keine

Bemerkungen

EapHostPeerQueryUserBlobFromCredentialInputFields unterstützt einmaliges Anmelden. Diese supplicant-Funktion wie EapHostPeerQueryCredentialInputFields wird nur in einem SSO-Szenario verwendet.

Nach EapHostPeerQueryUserBlobFromCredentialInputFields ruft EAPHostPeerBeginSession auf. Der Supplicant verwendet das flag EAP_FLAG_PRE_LOGON in EapHostPeerBeginSession , um anzugeben, dass EAPHost einmaliges Anmelden bereitstellen soll.

Anforderungen

Weitere Informationen

EAPHost Supplicant-Konfigurationsfunktionen

SSO und PLAP