EAP_AUTHENTICATOR_METHOD_ROUTINES 结构 (eapmethodauthenticatorapis.h)

包含一组指向 EAPHost Authenticator 方法 API 的函数指针。

语法

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;

成员

dwSizeInBytes

实现者定义的结构版本。

注意 Microsoft 未定义此字段的值。

 

pEapType

指向 EAP_METHOD_TYPE 结构的指针，该结构包含有关此结构成员所指向的 API 实现者的供应商信息。

EapMethodAuthenticatorInitialize

指向 EapMethodAuthenticatorInitialize 的函数指针。

pEapType

EAP_METHOD_TYPE 枚举值，该值指定要用于此会话的 EAP 身份验证的类型。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapPeerFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorBeginSession

指向 EapMethodAuthenticatorBeginSession 的函数指针。

dwFlags

描述 EAP 身份验证会话行为的 EAP 标志的组合。

pwszIdentity

包含要进行身份验证的用户标识的零终止 Unicode 字符串。

pAttributeArray

指向 EapAttributes 数组结构的指针，该结构指定要进行身份验证的实体的 EAP 属性。

dwSizeOfConnectionData

指定 pConnectionData 中提供的连接数据缓冲区的大小（以字节为单位）。

pConnectionData

指向包含不透明配置数据 BLOB 的字节缓冲区的指针。

dwMaxSendPacketSize

指定会话期间发送的 EAP 数据包的最大大小（以字节为单位）。

pSessionHandle

接收指向 EAP_SESSION_HANDLE 结构的指针，该结构包含服务器 EAPHost 上新 EAP 身份验证会话的唯一 ID。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapPeerFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorUpdateInnerMethodParams

指向 EapMethodAuthenticatorUpdateInnerMethodParams 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

dwFlags

描述 EAP 身份验证会话行为的 EAP 标志的组合。

pwszIdentity

包含要进行身份验证的用户的更新标识的零终止 Unicode 字符串。

pAttributeArray

指向 EapAttributes 数组结构的指针，该结构指定要进行身份验证的实体的更新 EAP 属性。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorReceivePacket

指向 EapMethodAuthenticatorReceivePacket 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

cbReceivePacket

pReceivePacket 的大小（以字节为单位）。

pReceivePacket

指向 EapPacket 结构的指针，该结构包含服务器 EAPHost 从请求方接收的 EAP 身份验证会话数据包。

pEapOutput

接收指向 EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION 枚举值的指针，该值指示请求者必须在 EAP 身份验证会话中采取的下一个操作。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorSendPacket

指向 EapMethodAuthenticatorSendPacket 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

bPacketId

指定要发送的数据包的数值 ID 值。

线路板包

指定要发送的数据包的最大大小（以字节为单位）。 返回时，此参数接收 pEapPacket 中返回的数据包的大小（以字节为单位）。

pSendPacket

接收指向 EapPacket 结构的指针，该结构包含要发送到请求方的数据包。

pTimeout

接收指向指定数据包超时 的EAP_AUTHENTICATOR_SEND_TIMEOUT 值的指针。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存

EapMethodAuthenticatorGetAttributes

指向 EapMethodAuthenticatorGetAttributes 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

pAttribs

接收指向 EapAttributes 结构的指针，该结构包含请求方 EAP 身份验证响应属性数组。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存

EapMethodAuthenticatorSetAttributes

指向 EapMethodAuthenticatorSetAttributes 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

pAttribs

指向 EapAttributes 结构的指针，该结构包含要为 EAPHost 上的请求者设置的新 EAP 身份验证响应属性数组。

pEapOutput

接收指向 EAP_METHOD_AUTHENTICATOR_RESPONSE_ACTION 枚举值的指针，该值指定请求者作为对更新属性的响应应采取的建议操作。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorGetResult

指向 EapMethodAuthenticatorGetResult 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含服务器 EAPHost 上 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的

pResult

接收指向包含身份验证结果 的EAP_METHOD_AUTHENTICATOR_RESULT 结构的指针。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorEndSession

指向 EapMethodAuthenticatorEndSession 的函数指针。

sessionHandle

EAP_SESSION_HANDLE 值，该值包含要在服务器 EAPHost 上关闭的 EAP 身份验证会话的特定句柄。 此句柄是通过之前调用 EapMethodAuthenticatorBeginSession 获取的。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

EapMethodAuthenticatorShutdown

指向 EapMethodAuthenticatorShutdown 的函数指针。

pEapType

一个EAP_METHOD_TYPE枚举值，该值指定会话中使用的 EAP 身份验证的类型。

ppEapError

指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过将指向错误数据的指针传递到 EapMethodAuthenticatorFreeErrorMemory 来释放此内存。

备注

每个 EAP 验证器方法 DLL 上都必须有以下 API 的公共实现。

• EapMethodAuthenticatorInitialize
• EapMethodAuthenticatorBeginSession
• EapMethodAuthenticatorUpdateInnerMethodParams
• EapMethodAuthenticatorReceivePacket
• EapMethodAuthenticatorSendPacket
• EapMethodAuthenticatorGetAttributes
• EapMethodAuthenticatorSetAttributes
• EapMethodAuthenticatorGetResult
• EapMethodAuthenticatorEndSession
• EapMethodAuthenticatorShutdown

当验证器 (服务器) EAPHost 接收来自对等方 (客户端) EAP 方法的特定对应远程过程调用时，将在 EAP 验证器方法上调用这些 API。 请注意，EAP 对等方法和 EAP 验证器方法之间不存在完整的一对一对应关系;必须根据实现 EAP 验证器方法 API 调用的要求进行特定的 EAP 验证器方法 API 调用。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	eapmethodauthenticatorapis.h

请参阅

EAPHost Authenticator 方法结构

EapMethodAuthenticatorGetInfo