функция обратного вызова PRADIUS_EXTENSION_PROCESS_EX (authif.h)

Статья
08/22/2023

Примечание Служба проверки подлинности в Интернете (IAS) была переименована в сервер политики сети (NPS), начиная с Windows Server 2008. Содержание этого раздела относится как к 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

Указатель на массив атрибутов , предоставляемых библиотекой DLL расширения NPS. Массив завершается атрибутом, для параметра dwAttrType задано значение ratMinimum. NPS добавляет эти атрибуты в ответ проверки подлинности.

Библиотека DLL расширения NPS выделяет память для массива атрибутов. NPS вызывает RadiusExtensionFreeAttributes , чтобы освободить память, занятую массивом атрибутов.

[out] pfAction

Указатель на значение типа RADIUS_ACTION, изначально заданное как raContinue. Этот параметр указывает действие, которое NPS должно предпринять в ответ на запрос доступа.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемым значением должен быть соответствующий код ошибки из WinError.h.

NPS поддерживает несколько библиотек DLL расширений. NPS вызывает RadiusExtensionProcessEx для каждого из библиотек DLL, перечисленных в реестре. Дополнительные сведения см. в разделе Настройка библиотек DLL расширений.

NPS вызывает RadiusExtensionFreeAttributes , чтобы освободить память, занятую массивом атрибутов, возвращенных RadiusExtensionProcessEx. По этой причине при реализации RadiusExtensionProcessEx необходимо также реализовать RadiusExtensionFreeAttributes.

Дополнительные сведения об использовании этой функции см. в разделе Процесс расширений NPS.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	authif.h