EapPeerBeginSession-Funktion (eapmethodpeerapis.h)
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 |