RadiusExtensionProcess Callback Function

The RadiusExtensionProcess function is an application-defined function and is called by Internet Authentication Service (IAS) for each authentication or accounting packet that IAS receives from the network access server (NAS).

DWORD WINAPI RadiusExtensionProcess(
  [in]                 const RADIUS_ATTRIBUTE* pAttrs,
  [out]                PRADIUS_ACTION pfAction
);

Parameters

• pAttrs
  Pointer to an array of attributes from the request. The array is terminated by an attribute with dwAttrType set to ratMinimum. These attributes should be treated as read-only; they should not be modified by RadiusExtensionProcess. Also, these attributes should not be referenced in any way after RadiusExtensionProcess returns.

• pfAction
  Pointer to a value of type RADIUS_ACTION, initially set to raContinue. This parameter specifies the action that IAS should take in response to an Access-Request.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value should be an appropriate error code from Winerror.h.

Remarks

If the return value is anything other than NO_ERROR, IAS discards the request.

IAS supports multiple Extension DLLs. IAS calls RadiusExtensionProcess for each of the DLLs listed in the registry. For more information see Setting Up the Extension and Authorization DLLs.

On Windows 2000 Server and later, the Extension DLL may export RadiusExtensionProcessEx instead of RadiusExtensionProcess. On Windows Server 2003, the Extension DLL may export RadiusExtensionProcess2.

Requirements

Server	Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Redistributable	Requires Windows NT 4.0 Option Pack on Windows NT Server 4.0 SP6a.
Header	Declared in AuthIf.h.

See Also

About Internet Authentication Service
Internet Authentication Service Reference
Internet Authentication Service Functions
RADIUS_ACTION
RADIUS_ATTRIBUTE
RADIUS_ATTRIBUTE_TYPE
RadiusExtensionProcessEx
RadiusExtensionProcess2

Send comments about this topic to Microsoft

Build date: 10/1/2007