Freigeben über

EAP_AUTHENTICATOR_METHOD_ROUTINES-Struktur (eapmethodauthenticatorapis.h)

  • Artikel

Enthält eine Reihe von Funktionszeigern auf die APIs der EAPHost Authenticator-Methode.

Syntax

typedef struct _EAP_AUTHENTICATOR_METHOD_ROUTINES {
  DWORD           dwSizeInBytes;
  EAP_METHOD_TYPE *pEapType;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorInitialize;
  DWORD(ORD dwFlags,LPCWSTR pwszIdentity, const EapAttributes * const pAttributeArray,DWORD dwSizeofConnectionData, const BYTE * const pConnectionData,DWORD dwMaxSendPacketSize,EAP_SESSION_HANDLE *pSessionHandle,EAP_ERROR **ppEapError)          * )(DWEapMethodAuthenticatorBeginSession;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD dwFlags, const WCHAR *pwszIdentity, const EapAttributes * const pAttributeArray,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorUpdateInnerMethodParams;
  DWORD(AP_SESSION_HANDLE sessionHandle,DWORD cbReceivePacket, const EapPacket * const pReceivePacket,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorReceivePacket;
  DWORD(P_SESSION_HANDLE sessionHandle,BYTE bPacketId,DWORD *pcbSendPacket,EapPacket *pSendPacket,EAP_AUTHENTICATOR_SEND_TIMEOUT *pTimeout,EAP_ERROR **ppEapError)          * )(EAEapMethodAuthenticatorSendPacket;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EapAttributes *pAttribs,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetAttributes;
  DWORD(AP_SESSION_HANDLE sessionHandle, const EapAttributes * const pAttribs,EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION *pEapOutput,EAP_ERROR **ppEapError)          * )(EEapMethodAuthenticatorSetAttributes;
  DWORD(EAP_SESSION_HANDLE sessionHandle,EAP_METHOD_AUTHENTICATOR_RESULT *pResult,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorGetResult;
  DWORD((EAP_SESSION_HANDLE sessionHandle,EAP_ERROR **ppEapError)          * )EapMethodAuthenticatorEndSession;
  DWORD(EAP_METHOD_TYPE *pEapType,EAP_ERROR **ppEapError)          * )(EapMethodAuthenticatorShutdown;
} EAP_AUTHENTICATOR_METHOD_ROUTINES, *PEAP_AUTHENTICATOR_METHOD_ROUTINES;

Member

dwSizeInBytes

Die vom Implementierer definierte Strukturversion.

Hinweis Die Werte für dieses Feld werden nicht von Microsoft definiert.
 

pEapType

Ein Zeiger auf eine EAP_METHOD_TYPE Struktur, die die Anbieterinformationen zum Implementierer der APIs enthält, auf die von den Membern dieser Struktur verwiesen wird.

EapMethodAuthenticatorInitialize

Funktionszeiger auf EapMethodAuthenticatorInitialize.

pEapType

EAP_METHOD_TYPE Enumerationswert, der den Typ der EAP-Authentifizierung angibt, die für diese Sitzung verwendet werden soll.

ppEapError

Ein Zeiger auf die Adresse einer 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 EapPeerFreeErrorMemory übergeben wird.

EapMethodAuthenticatorBeginSession

Funktionszeiger auf EapMethodAuthenticatorBeginSession.

dwFlags

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

pwszIdentity

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

pAttributeArray

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

dwSizeOfConnectionData

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

pConnectionData

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

dwMaxSendPacketSize

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

pSessionHandle

Empfängt einen Zeiger auf eine EAP_SESSION_HANDLE Struktur, die die eindeutige ID für die neue EAP-Authentifizierungssitzung auf dem Server EAPHost enthält.

ppEapError

Ein Zeiger auf die Adresse einer 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 EapPeerFreeErrorMemory übergeben wird.

EapMethodAuthenticatorUpdateInnerMethodParams

Funktionszeiger auf EapMethodAuthenticatorUpdateInnerMethodParams.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

dwFlags

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

pwszIdentity

Unicode-Zeichenfolge ohne Ende, die die aktualisierte Identität des zu authentifizierden Benutzers enthält.

pAttributeArray

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

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.

EapMethodAuthenticatorReceivePacket

Funktionszeiger auf EapMethodAuthenticatorReceivePacket.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

cbReceivePacket

Die Größe von pReceivePacket in Bytes.

pReceivePacket

Ein Zeiger auf eine EapPacket-Struktur , die ein EAP-Authentifizierungssitzungspaket enthält, das vom Supplicant vom Server EAPHost empfangen wurde.

pEapOutput

Empfängt einen Zeiger auf einen EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION Enumerationswert, der die nächste Aktion angibt, die der Supplicant in der EAP-Authentifizierungssitzung ausführen muss.

ppEapError

Ein Zeiger auf die Adresse einer 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 EapMethodAuthenticatorFreeErrorMemory übergeben wird.

EapMethodAuthenticatorSendPacket

Funktionszeiger auf EapMethodAuthenticatorSendPacket.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

bPacketId

Gibt einen numerischen ID-Wert für das zu sendende Paket an.

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.

pSendPacket

Empfängt einen Zeiger auf eine EapPacket-Struktur , die das Paket enthält, das an das Supplicant gesendet werden soll.

pTimeout

Empfängt einen Zeiger auf einen EAP_AUTHENTICATOR_SEND_TIMEOUT Wert, der das Timeout für das Paket angibt.

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 dem Verbrauch der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapMethodAuthenticatorFreeErrorMemory übergeben wird.

EapMethodAuthenticatorGetAttributes

Funktionszeiger auf EapMethodAuthenticatorGetAttributes.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

pAttribs

Empfängt einen Zeiger auf eine EapAttributes-Struktur , die ein Array von EAP-Authentifizierungsantwortattributen für das Supplicant enthält.

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 dem Verbrauch der Fehlerdaten muss dieser Arbeitsspeicher freigegeben werden, indem ein Zeiger auf die Fehlerdaten an EapMethodAuthenticatorFreeErrorMemory übergeben wird.

EapMethodAuthenticatorSetAttributes

Funktionszeiger auf EapMethodAuthenticatorSetAttributes.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

pAttribs

Zeiger auf eine EapAttributes-Struktur , die ein Array mit neuen EAP-Authentifizierungsantwortattributen enthält, die für das Supplicant auf EAPHost festgelegt werden sollen.

pEapOutput

Empfängt einen Zeiger auf einen EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION Enumerationswert, der die vorgeschlagene Aktion angibt, die der Supplicant als Antwort auf die aktualisierten Attribute ausführen soll.

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.

EapMethodAuthenticatorGetResult

Funktionszeiger auf EapMethodAuthenticatorGetResult.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung auf dem Server EAPHost enthält. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

pResult

Empfängt einen Zeiger auf eine EAP_METHOD_AUTHENTICATOR_RESULT Struktur, die die Authentifizierungsergebnisse enthält.

ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost 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.

EapMethodAuthenticatorEndSession

Funktionszeiger auf EapMethodAuthenticatorEndSession.

sessionHandle

EAP_SESSION_HANDLE Wert, der das spezifische Handle für die EAP-Authentifizierungssitzung enthält, die auf dem Server EAPHost geschlossen werden soll. Dieses Handle wird durch einen vorherigen Aufruf von EapMethodAuthenticatorBeginSession abgerufen.

ppEapError

Ein Zeiger auf die Adresse einer EAP_ERROR-Struktur , die alle Fehler enthält, die von EAPHost 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.

EapMethodAuthenticatorShutdown

Funktionszeiger auf EapMethodAuthenticatorShutdown.

pEapType

Ein EAP_METHOD_TYPE Enumerationswert, der den Typ der in der Sitzung verwendeten EAP-Authentifizierung angibt.

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.

Hinweise

Jede DLL für EAP-Authentifikatormethoden muss über öffentliche Implementierungen der folgenden APIs verfügen.

Diese APIs werden für eine EAP-Authentifikatormethode aufgerufen, wenn ein Authentifikator (Server) EAPHost einen bestimmten entsprechenden Remoteprozeduraufruf von einer Peer-EAP-Methode (Client) empfängt. Beachten Sie, dass zwischen EAP-Peermethoden und EAP-Authentifikatormethoden keine vollständige 1:1-Korrespondenz vorhanden ist. Die API-Aufrufe der spezifischen EAP-Authentifikatormethode müssen basierend auf den Anforderungen Ihrer Implementierung der API-Aufrufe der EAP-Authentifikatormethode erfolgen.

Anforderungen

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

Weitere Informationen

EAPHost Authenticator-Methodenstrukturen

EapMethodAuthenticatorGetInfo