EapHostPeerInvokeIdentityUI-Funktion (eaphostpeerconfigapis.h)

Diese Funktion wird von Tunnelmethoden aufgerufen, um die Identitäts-UI der inneren Methoden aufzurufen. Diese Funktion gibt die Identität sowie Anmeldeinformationen zurück, die zum Starten der Authentifizierung verwendet werden sollen.

Syntax

DWORD EapHostPeerInvokeIdentityUI(
  [in]      DWORD           dwVersion,
  [in]      EAP_METHOD_TYPE eapMethodType,
  [in]      DWORD           dwFlags,
  [in]      HWND            hwndParent,
  [in]      DWORD           dwSizeofConnectionData,
  [in]      const BYTE      *pConnectionData,
  [in]      DWORD           dwSizeofUserData,
  [in]      const BYTE      *pUserData,
  [in, out] DWORD           *pdwSizeOfUserDataOut,
  [out]     BYTE            **ppUserDataOut,
  [out]     LPWSTR          *ppwszIdentity,
  [out]     EAP_ERROR       **ppEapError,
  [in, out] LPVOID          *ppvReserved
);

Parameter

[in] dwVersion

Die Versionsnummer der API. Muss auf 0 festgelegt werden.

[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 von EAP-Flags , die das Verhalten der EAP-Authentifizierungssitzung beschreiben.

[in] hwndParent

Handle des übergeordneten Fensters, in dem das Konfigurationsdialogfeld angezeigt wird.

[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 Authentifizierung beziehen.

[in, out] pdwSizeOfUserDataOut

Größe des Puffersatzes zum Empfangen der Benutzerdaten, die vom ppUserDataOut-Parameter zurückgegeben werden, in Bytes.

[out] ppUserDataOut

Ein Zeiger auf einen Zeiger auf einen Puffer, der von der -Methode zurückgegebene Benutzerdateninformationen enthält. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory freigegeben werden.

[out] ppwszIdentity

Ein Zeiger auf eine MIT NULL beendete Benutzeridentitätszeichenfolge. Nach der Verwendung muss dieser Arbeitsspeicher durch Aufrufen von EapHostPeerFreeMemory 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-Konfigurationsfunktionen