PRADIUS_EXTENSION_PROCESS_EX回调函数 (authif.h)

项目
08/22/2023

注意从 Windows Server 2008 开始， (IAS) 的 Internet 身份验证服务 (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 扩展过程。