EapPeerBeginSession-Funktion (eapmethodpeerapis.h)

Artikel
08/23/2023

Startet eine EAP-Authentifizierungssitzung auf dem Peer-EAPHost mithilfe der EAP-Methode.

Syntax

DWORD EapPeerBeginSession(
  [in]  DWORD                       dwFlags,
  [in]  const EapAttributes * const pAttributeArray,
  [in]  HANDLE                      hTokenImpersonateUser,
  [in]  DWORD                       dwSizeofConnectionData,
  [in]  BYTE                        *pConnectionData,
  [in]  DWORD                       dwSizeofUserData,
  [in]  BYTE                        *pUserData,
  [in]  DWORD                       dwMaxSendPacketSize,
  [out] EAP_SESSION_HANDLE          *pSessionHandle,
  [out] EAP_ERROR                   **ppEapError
);

Parameter

[in] dwFlags

Eine Kombination von EAP-Flags , die das neue EAP-Authentifizierungssitzungsverhalten beschreiben.

[in] pAttributeArray

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

[in] hTokenImpersonateUser

Gibt ein Handle für das Benutzerwechseltoken an, das in dieser Sitzung verwendet werden soll.

[in] dwSizeofConnectionData

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

[in] pConnectionData

Verbindungsdaten, die speziell für diese Methode verwendet werden, um die von dieser API zurückgegebenen Benutzerdaten zu bestimmen, wobei die Benutzerdaten von einer bestimmten Verbindungsdatenkonfiguration abhängen. Wenn dieser Parameter NULL ist, sollte die Methodenimplementierung Standardwerte für die Verbindung verwenden.

[in] dwSizeofUserData

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

[in] pUserData

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

[in] dwMaxSendPacketSize

Gibt die maximale Größe eines während der Sitzung gesendeten EAP-Pakets in Bytes an. Wenn die -Methode ein Paket senden muss, das größer als die maximale Größe ist, muss die Methode fragmentiert und neu zusammengesetzt werden.

[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

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 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


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

Weitere Informationen

EAPHost-Peermethode Run-Time Funktionen

EapPeerEndSession

SSO und PLAP

Freigeben über