PRADIUS_EXTENSION_PROCESS_EX 콜백 함수(authif.h)

아티클
03/14/2023

참고 IAS(인터넷 인증 서비스)의 이름이 Windows Server 2008부터 NPS(네트워크 정책 서버)로 바뀌었습니다. 이 항목의 내용은 IAS 및 NPS 모두에 적용됩니다. 텍스트 전체에서 NPS는 원래 IAS라고 하는 버전을 포함하여 서비스의 모든 버전을 참조하는 데 사용됩니다.

RadiusExtensionProcessEx 함수는 애플리케이션 정의 함수이며 NPS가 NAS(네트워크 액세스 서버)에서 수신하는 각 인증 또는 회계 패킷에 대해 NPS에서 호출됩니다. 이 함수는 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

처음에 raContinue로 설정된 RADIUS_ACTION 형식의 값에 대한 포인터입니다. 이 매개 변수는 Access-Request에 대한 응답으로 NPS가 수행해야 하는 작업을 지정합니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 WinError.h의 적절한 오류 코드여야 합니다.

설명

반환 값이 NO_ERROR 이외의 값이면 NPS는 요청을 삭제합니다.

NPS는 여러 확장 DLL을 지원합니다. NPS는 레지스트리에 나열된 각 DLL에 대해 RadiusExtensionProcessEx 를 호출합니다. 자세한 내용은 확장 DLL 설정을 참조하세요.

NPS 는 RadiusExtensionFreeAttributes 를 호출하여 RadiusExtensionProcessEx에서 반환된 특성 배열에서 차지하는 메모리를 해제합니다. 이러한 이유로 RadiusExtensionProcessEx를 구현하는 경우 RadiusExtensionFreeAttributes도 구현해야 합니다.

이 함수의 사용에 대한 자세한 내용은 NPS 확장 프로세스를 참조하세요.

요구 사항


지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	authif.h