Freigeben über


EapMethodAuthenticatorBeginSession-Funktion (eapmethodauthenticatorapis.h)

Erstellt eine neue EAP-Authentifizierungssitzung auf dem Server EAPHost.

EapMethodAuthenticatorBeginSession ist ein Funktionsprototyp.

Syntax

DWORD EapMethodAuthenticatorBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  BYTE                        bInitialId,
        LPCWSTR                     pwszIdentity,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  DWORD                       dwSizeofConnectionData,
        const BYTE * const          pConnectionData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parameter

[in] dwFlags

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

[in] bInitialId

Eine Unicode-Zeichenfolge mit Null-Endung, die die Identität des zu authentifizierden Benutzers enthält.

pwszIdentity

Identität des authentifizierten Benutzers.

[in] pAttributeArray

Ein Zeiger auf eine EapAttributes-Arraystruktur , die die EAP-Attribute der zu authentifizierden Entität angibt.

[in] dwSizeofConnectionData

Gibt die Größe der Daten in Bytes an, auf die von pConnectionData verwiesen wird. Wenn pConnectionData NULL ist, ist dieser Member 0.

pConnectionData

Zeiger auf Verbindungsdaten, die von der Konfigurationsbenutzerschnittstelle des Authentifizierungsprotokolls empfangen werden.

[in] dwMaxSendPacketSize

Gibt die maximale Größe eines während der Sitzung gesendeten EAP-Pakets in Bytes an.

[out] pSessionHandle

Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält.

[out] ppEapError

Empfängt optional einen 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 werden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapMethodAuthenticatorFreeMemory übergeben wird.

Rückgabewert

Keine

Bemerkungen

Dieser Aufruf wird von einem Authentifikator-basierten EAPHost ausgeführt, der einen Funktionszeiger auf diese API verwendet. Diese API muss für die von EAPHost geladene EAP-Authentifikatormethode implementiert werden und muss den in der Dokumentation angegebenen Syntax- und Parametertypen streng entsprechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile eapmethodauthenticatorapis.h

Weitere Informationen

Funktionen der EAPHost Authenticator-Methode

EapHostPeerBeginSession