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