PPP_EAP_INFO 結構 (raseapif.h)
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 會使用這個值來判斷 PPP_EAP_INFO 結構 RAS 所使用的版本。
dwEapTypeId
指定特定的驗證通訊協定。 此標識碼在整個產業的 EAP 實作中必須是唯一的。 驗證通訊協議的實作者必須從因特網指派號碼授權單位 (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 正在起始具有驗證通訊協議的對話框,或是發生逾時,而且驗證通訊協議應該重新傳送最後一個封包。 驗證通訊協議必須根據內容來判斷這兩個案例中的哪一個是 true。
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 |