EapPeerGetIdentity-Funktion (eapmethodpeerapis.h)

Gibt die Benutzerdaten und die Benutzeridentität zurück, nachdem sie von EAPHost aufgerufen wurden.

Syntax

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

Parameter

[in] dwFlags

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

[in] dwSizeofConnectionData

Gibt die Größe des In pConnectionData bereitgestellten Verbindungsdatenpuffers in Bytes an.

[in] pConnectionData

Ein Zeiger auf einen Bytepuffer, der das undurchsichtige Konfigurationsdatenblob enthält.

[in] dwSizeofUserData

Gibt die Größe des in pUserData bereitgestellten Benutzerdatenpuffers in Bytes an.

[in] pUserData

Ein Zeiger auf die Benutzerdaten, die für diese Authentifizierung spezifisch sind und zum Vorabfüllen der Benutzerdaten verwendet werden. Wenn diese API zum ersten Mal aufgerufen wird oder eine neue Authentifizierungssitzung gestartet wird, ist dieser Parameter NULL. Legen Sie andernfalls diesen Parameter auf das pUserData-Element der Struktur fest, auf das der ppResult-Parameter verweist, der von EapPeerGetResult empfangen wurde.

[in] hTokenImpersonateUser

Gibt ein Handle für das Identitätswechseltoken des authentifizierten Benutzers an. Dieses Handle ist NULL , wenn die Computerauthentifizierung ausgeführt wird. Mithilfe dieses Handles kann eine EAP-Methode die Identität des Benutzers annehmen, um benutzerspezifische Informationen wie Benutzername, Domänenname und Anmeldeinformationen abzurufen.

[out] pfInvokeUI

Gibt TRUE zurück, wenn die Benutzeridentität und das Benutzerdatenblob nicht erfolgreich zurückgegeben werden und die Methode versucht, die Informationen vom Benutzer über das Dialogfeld "Benutzeroberfläche" zu sammeln.

[in, out] pdwSizeOfUserDataOut

Gibt die Größe des ppUserDataOut-Puffers in Bytes an.

[out] ppUserDataOut

Ein Zeiger auf einen Zeiger auf die zurückgegebenen Benutzerdaten. Die Daten werden als Eingabe pUserData an EapPeerBeginSession übergeben.

[out] ppwszIdentity

Ein Zeiger auf die zurückgegebene Benutzeridentität. Der Zeiger wird im Identitätsantwortpaket enthalten und an den Server zurückgegeben.

[out] ppEapError

Ein Zeiger auf den Zeiger auf eine 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 durch Aufrufen von EapPeerFreeErrorMemory freigegeben werden.

Rückgabewert

Keine

Bemerkungen

Dieser Aufruf wird von einem peerbasierten EAPHost mit einem Funktionszeiger auf diese API ausgeführt. Diese API muss für die von EAPHost geladene EAP-Methode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.

Anforderungen

Weitere Informationen

EAPHost-Peermethode Run-Time Funktionen

EapPeerInvokeIdentityUI