EapMethodAuthenticatorSendPacket-Funktion (eapmethodauthenticatorapis.h)
Ruft ein Authentifizierungspaket von der EAP-Authentifikatormethode ab, das an das Supplicant gesendet werden soll.
EapMethodAuthenticatorSendPacket ist ein Funktionsprototyp.
Syntax
DWORD EapMethodAuthenticatorSendPacket(
[in] EAP_SESSION_HANDLE sessionHandle,
[in] BYTE bPacketId,
[in, out] DWORD *pcbSendPacket,
[out] EapPacket *pSendPacket,
[out] EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,
[out] EAP_ERROR **ppEapError
);
Parameter
[in] sessionHandle
Ein Zeiger auf eine EAP_SESSION_HANDLE Struktur, die das eindeutige Handle für diese EAP-Authentifizierungssitzung auf dem EAPHost-Server enthält. Dieses Handle wird im pSessionHandle-Parameter in einem vorherigen Aufruf von EapMethodAuthenticatorBeginSession zurückgegeben.
[in] bPacketId
Gibt einen numerischen ID-Wert für das zu sendende Paket an.
[in, out] pcbSendPacket
Gibt die maximale Größe des zu sendenden Pakets in Bytes an. Bei der Rückgabe empfängt dieser Parameter die Größe des in pEapPacket zurückgegebenen Pakets in Bytes.
[out] pSendPacket
Ein Zeiger auf eine EapPacket-Struktur , die das Paket enthält, das an das Supplicant gesendet werden soll.
[out] pTimeout
Ein Zeiger auf eine EAP_AUTHENTICATOR_SEND_TIMEOUT-Enumeration , die das Timeout für das Paket angibt.
[out] ppEapError
Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die während der Ausführung dieses Funktionsaufrufs ausgelöst wurden. Nach der Nutzung der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapMethodAuthenticatorFreeErrorMemory ü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 |