SetResponseType Callback Function

The SetResponseType function sets the final disposition of the request.

DWORD WINAPI SetResponseType(
  [in]                 _RADIUS_EXTENSION_CONTROL_BLOCK* This,
  [in]                 RADIUS_CODE rcResponseType
);

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 function.

  • rcResponseType
    Specifies the response type. This parameter must be one of the values contained within the RADIUS_CODE enumerated type and is related to the rcRequestType member of the RADIUS_EXTENSION_CONTROL_BLOCK structure. If rcRequestType equals rcAccessRequest, this value may be rcAccessAccept, rcAccessReject, rcAccessChallenge, or rcDiscard. If rcRequestType equals rcAccountingRequest, this value can be rcAccountingResponse or rcDiscard. Otherwise, the function fails, returning ERROR_INVALID_PARAMETER.

Return Value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Return code Description

ERROR_INVALID_PARAMETER

The specified response type is invalid for the request type.

Remarks

Note that the disposition set by the Extension DLL can be overridden during further processing. For example, the Extension DLL may set the response type to rcAccessAccept, but during further processing, the response can be changed to rcAccessReject.

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
RADIUS_CODE
RADIUS_EXTENSION_CONTROL_BLOCK

Send comments about this topic to Microsoft

Build date: 10/1/2007