PPP_EAP_INFO 结构 (raseapif.h)

项目
08/25/2023

PPP_EAP_INFO 结构向连接管理器提供有关身份验证协议的信息，包括指向 EAP DLL 中函数的指针。

语法

typedef struct _PPP_EAP_INFO {
  DWORD  dwSizeInBytes;
  DWORD  dwEapTypeId;
  DWORD( )(BOOL fInitialize) *RasEapInitialize;
  DWORD(VOID **ppWorkBuffer,PPP_EAP_INPUT *pPppEapInput) * )(RasEapBegin;
  DWORD()(VOID *pWorkBuffer) * RasEapEnd;
  DWORD(ID *pWorkBuf,PPP_EAP_PACKET *pReceivePacket,PPP_EAP_PACKET *pSendPacket,DWORD cbSendPacket,PPP_EAP_OUTPUT *pEapOutput,PPP_EAP_INPUT *pEapInput) * )(VORasEapMakeMessage;
} PPP_EAP_INFO, *PPPP_EAP_INFO;

成员

dwSizeInBytes

指定 PPP_EAP_INFO 结构的大小。 RAS 将此值传递给 EAP DLL。 DLL 使用此值来确定 RAS 使用的 PPP_EAP_INFO 结构版本。

dwEapTypeId

指定特定的身份验证协议。在整个 EAP 全行业实现过程中，此标识符必须是唯一的。身份验证协议的实施者必须从 Internet 号码分配机构 (IANA) 获取此标识符。

RasEapInitialize

指向身份验证协议的 RasEapInitialize 函数的指针。身份验证协议设置此成员的值。身份验证协议可将此成员设置为 NULL，在这种情况下，协议不需要 RAS 调用此函数。

fInitialize

指定身份验证协议应初始化还是取消初始化。如果协议初始化，则此参数为 TRUE ;如果协议未初始化，此参数为 FALSE 。

RasEapBegin

指向所请求身份验证协议的 RasEapBegin 函数的指针。身份验证协议设置此成员的值。此成员可以为 NULL，在这种情况下，身份验证协议不需要任何初始化。如果此成员为 NULL，RAS 将忽略 RasEapEnd 成员。

ppWorkBuffer

指向成功返回时指向工作缓冲区的指针的指针。此缓冲区对 RAS 不透明;缓冲区的内容仅由身份验证协议使用。 RAS 连接管理器在后续调用 RasEapMakeMessage 时将指向此缓冲区的指针传递给身份验证协议。

pPppEapInput

指向 PPP_EAP_INPUT 结构的指针，该结构指定身份验证会话的初始化信息。

RasEapEnd

指向身份验证协议的 RasEapEnd 函数的指针。身份验证协议设置此成员的值。

pWorkBuffer

指向要释放的工作缓冲区的指针。

RasEapMakeMessage

指向所请求身份验证协议的 RasEapMakeMessage 函数的指针。身份验证协议设置此成员的值。

pWorkBuf

指向工作缓冲区的指针。身份验证协议通过 RasEapBegin 函数为 RAS 提供指向此缓冲区的指针。

pReceivePacket

指向包含已接收数据包的PPP_EAP_PACKET 结构的指针。 pReceivePacket 值为 NULL 表示 RAS 正在启动具有身份验证协议的对话，或者已超时，身份验证协议应重新发送最后一个数据包。身份验证协议必须根据上下文确定这两种情况中的哪一种是正确的。

pSendPacket

指向 PPP_EAP_PACKET 结构的指针。身份验证协议可以使用此结构指定要发送的数据包。

cbSendPacket

指定 pSendPacket 指向的缓冲区的大小（以字节为单位）。

pEapOutput

指向 PPP_EAP_OUTPUT 结构的指针。

pEapInput

指向 PPP_EAP_INPUT 结构的指针。此参数可以为 NULL。

注解

给定的 EAP DLL 可以实现多个身份验证协议。使用 dwEapTypeId 成员指定要检索信息的协议。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	raseapif.h