大网数据广告活动
网络与域名解析

Implementing NAP Support for EAP Methods

· 52CE 我爱测

Learn how to implement NAP support for an EAPHost supplicant. See EAPHost-related NAP topics and view additional available resources.

This topic explains how to implement Network Access Protection (NAP) for an EAPHost supplicant. In Windows Vista and Windows Server 2008 a NAP Enforcement Client (NAP EC) is available for 802.1X authenticated connections.

Important: NAP was deprecated in Windows Server 2012 R2 and is not included in Windows Server 2016 or later.

Implementing Network Access Protection (NAP)

To support NAP, an EAPHost supplicant implements a callback function matching the NotificationHandler callback prototype and must provide a pointer to this callback function when calling EapHostPeerBeginSession.

The callback function takes two parameters.

  • A GUID that uniquely identifies the interface associated with the authentication.
  • A VOID pointer to an opaque data structure that is supplied by the supplicant.

EAPHost will call the supplicant-provided callback function with the unique interface GUID and the VOID pointer when the quarantine state of the machine changes. When EAPHost calls the supplicant-provided callback function, the supplicant responds by tearing down the logical network connection identified by the interface GUID/VOID pointer and begins authentication again using EapHostPeerBeginSession.

EAPHost may call the supplicant-supplied callback function at any time: before, during an active authentication, or after the authentication has been completed (after EapHostPeerEndSession has been called but not before EapHostPeerClearConnection has been called). The supplicant should always respond by tearing down the logical network connection and re-authenticating.

If the supplicant is shutting down or choosing to no longer receive notification of isolation state changes, the supplicant should call EapHostPeerClearConnection and specify the appropriate interface GUID. If the supplicant wishes to determine the isolation of the logical network connection, the supplicant can obtain that information from EapHostPeerMethodResult.isolationState when the EapHostPeerMethodResult is obtained from EapHostPeerGetResult.

EAPHost Related NAP Information

For EAPHost API related NAP information refer to the following topics.

Additional Resources

Related topics

Configuring the EAP Method User Interface

Enabling Group Policy

Implementing In-Band NAP Support for EAP Methods

Transferring Data Between the Supplicant and EAP Methods

EAPHost Supplicants

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/01/2023
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。