Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SetResponseType callback function

Note  Internet Authentication Service (IAS) was renamed Network Policy Server (NPS) starting with Windows Server 2008. The content of this topic applies to both IAS and NPS. Throughout the text, NPS is used to refer to all versions of the service, including the versions originally referred to as IAS.
 

The SetResponseType function sets the final disposition of the request.

Syntax


DWORD WINAPI SetResponseType(
  _In_ _RADIUS_EXTENSION_CONTROL_BLOCK *This,
  _In_ RADIUS_CODE                     rcResponseType
);

Parameters

This [in]

Pointer to a RADIUS_EXTENSION_CONTROL_BLOCK structure. NPS passes the Extension DLL a pointer to this structure when it calls the RadiusExtensionProcess2 function.

rcResponseType [in]

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.

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 NPS. NPS returns a pointer to this function as a member of the RADIUS_EXTENSION_CONTROL_BLOCK structure.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

AuthIf.h

See also

About NPS Extensions
NPS Extensions Reference
NPS Extensions Functions
RADIUS_CODE
RADIUS_EXTENSION_CONTROL_BLOCK

 

 

Show: