PRADIUS_EXTENSION_PROCESS_EX回调函数 (authif.h)

项目
03/14/2023

注意从 Windows Server 2008 开始，Internet 身份验证服务 (IAS) 已重命名为网络策略服务器 (NPS) 。本主题的内容适用于 IAS 和 NPS。在整个文本中，NPS 用于引用服务的所有版本，包括最初称为 IAS 的版本。

RadiusExtensionProcessEx 函数是应用程序定义的函数，由 NPS 针对 NPS 从网络访问服务器接收的每个身份验证或会计数据包调用， (NAS) 。此函数类似于 RadiusExtensionProcess。但是， RadiusExtensionProcessEx 使扩展 DLL 能够将属性追加到身份验证响应。

语法

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

DWORD PradiusExtensionProcessEx(
  [in]  const RADIUS_ATTRIBUTE *pInAttrs,
  [out] PRADIUS_ATTRIBUTE *pOutAttrs,
  [out] PRADIUS_ACTION pfAction
)
{...}

参数

[in] pInAttrs

指向请求中的属性数组的指针。数组由 dwAttrType 设置为 ratMinimum 的属性终止。这些属性应视为只读; RadiusExtensionProcessEx 不应修改它们。此外，在 RadiusExtensionProcessEx 返回后，不应以任何方式引用这些属性。

[out] pOutAttrs

指向 NPS 扩展 DLL 提供的属性数组的指针。数组由 dwAttrType 设置为 ratMinimum 的属性终止。 NPS 将这些属性添加到身份验证响应中。

NPS 扩展 DLL 为属性数组分配内存。 NPS 调用 RadiusExtensionFreeAttributes 来释放属性数组占用的内存。

[out] pfAction

指向 RADIUS_ACTION类型的值的指针，最初设置为 raContinue。此参数指定 NPS 在响应 Access-Request 时应执行的操作。

返回值

如果函数成功，则返回值 NO_ERROR。

如果函数失败，则返回值应是 WinError.h 中的相应错误代码。

注解

如果返回值不是 NO_ERROR，则 NPS 会放弃请求。

NPS 支持多个扩展 DLL。 NPS 为注册表中列出的每个 DLL 调用 RadiusExtensionProcessEx 。有关详细信息，请参阅设置扩展 DLL。

NPS 调用 RadiusExtensionFreeAttributes 以释放 RadiusExtensionProcessEx 返回的属性数组占用的内存。因此，如果实现 RadiusExtensionProcessEx，还必须实现 RadiusExtensionFreeAttributes。

有关使用此函数的详细信息，请参阅 NPS 扩展过程。