GetRequest Callback Function

The GetRequest function returns the attributes received in the RADIUS request process and any internal attributes describing the request state.

PRADIUS_ATTRIBUTE_ARRAY WINAPI GetRequest(
  [in]                 _RADIUS_EXTENSION_CONTROL_BLOCK* This
);

Parameters

• This
  Pointer to a RADIUS_EXTENSION_CONTROL_BLOCK structure. IAS passes the Extension DLL a pointer to this structure when it calls the RadiusExtensionProcess2 structure.

Return Value

If the function succeeds, the return value is a pointer to a RADIUS_ATTRIBUTE_ARRAY structure that represents the attributes in the RADIUS request.

If the function fails, the return value is a NULL pointer.

Remarks

The Extension DLL can modify the attributes in the RADIUS request. For example, if IAS is acting as a RADIUS proxy, an Extension DLL could filter which attributes are forwarded to the remote RADIUS server.

To modify the attributes, the Extension DLL uses the functions provided as members of the RADIUS_ATTRIBUTE_ARRAY structure.

This function is provided by Internet Authentication Service (IAS). IAS returns a pointer to this function as a member of the RADIUS_EXTENSION_CONTROL_BLOCK structure.

Requirements

Server	Requires Windows Server 2008 or Windows Server 2003.
Header	Declared in AuthIf.h.

See Also

About Internet Authentication Service
Internet Authentication Service Reference
Internet Authentication Service Functions
RadiusExtensionProcess2
RADIUS_ATTRIBUTE_ARRAY
RADIUS_EXTENSION_CONTROL_BLOCK

Send comments about this topic to Microsoft

Build date: 10/1/2007