EapHostPeerGetIdentity-Funktion (eappapis.h)

Diese Funktion wird von Tunnelmethoden aufgerufen, um Identitätsinformationen von den inneren Methoden anzufordern. Diese Funktion gibt die Identitäts- und Benutzeranmeldeinformationen zurück.

Syntax

DWORD EapHostPeerGetIdentity(
  [in]      DWORD           dwVersion,
  [in]      DWORD           dwFlags,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [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,
  [in, out] BYTE            **ppvReserved
);

Parameter

[in] dwVersion

Die Versionsnummer der API. Muss auf 0 festgelegt werden.

[in] dwFlags

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

[in] eapMethodType

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

[in] dwSizeofConnectionData

Größe des Puffers, der durch den pConnectionData-Parameter in Bytes angegeben wird.

[in] pConnectionData

Zeiger auf Konfigurationsdaten, die für die EAP-Methode verwendet werden.

[in] dwSizeofUserData

Größe des Puffers, der durch den pUserData-Parameter in Bytes angegeben wird.

[in] pUserData

Zeiger auf Benutzeranmeldeinformationen, die sich auf diese Authentifizierungssitzung beziehen.

[in] hTokenImpersonateUser

Identitätswechseltoken für einen angemeldeten Benutzer, um benutzerbezogene Informationen zu sammeln.

[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

Größe des Puffers, der durch den ppUserDataOut-Parameter in Bytes angegeben wird.

[out] ppUserDataOut

Benutzerdateninformationen, die von der -Methode zurückgegeben werden. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeRuntimeMemory freigegeben werden.

[out] ppwszIdentity

Ein Zeiger auf eine MIT NULL beendete Benutzeridentitätszeichenfolge. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeRuntimeMemory freigegeben werden.

[out] ppEapError

Ein Zeiger auf einen Zeiger auf eine EAP_ERROR-Struktur , die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst werden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeErrorMemory freigegeben werden.

[in, out] ppvReserved

Für die zukünftige Verwendung reserviert

Rückgabewert

Keine

Anforderungen

Weitere Informationen

EAPHost Supplicant Run-Time Functions

EapHostPeerGetUIContext