Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXFirewall2::CreateRadiusAuthenticator

The CreateRadiusAuthenticator method creates a RADIUS authenticator interface (IFWXRadiusAuthenticator), which can be used to authenticate RADIUS users.

HRESULT CreateRadiusAuthenticator(
  IFWXRadiusAuthenticator** ppIFWXRadiusAuthenticator
);

Parameters

ppIFWXRadiusAuthenticator
[out] Address of an interface pointer that on return points to the new IFWXRadiusAuthenticator interface created.

Return Values

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

An application filter can use the IFWXFirewall2::CreateRadiusAuthenticator method to get the IFWXRadiusAuthenticator interface. When a request is received on a listener that has RADIUS authentication enabled, and the application filter needs to perform RADIUS authentication, it calls IFWXRadiusAuthenticator::AuthenticateRadiusUser and gives it a pointer to its IFWXAuthenticationCompletion callback.

A component that has to perform RADIUS authentication should first call this method to obtain a RADIUS authenticator interface from the Microsoft Firewall service. Then the component can use this interface to perform RADIUS authentication, by invoking its IFWXRadiusAuthenticator::AuthenticateRadiusUser method. The component can keep a single instance of the interface and repeatedly invoke its IFWXRadiusAuthenticator::AuthenticateRadiusUser method for each user that requires authentication. When the component no longer needs to perform RADIUS authentication, it can release the IFWXRadiusAuthenticator interface.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXFirewall2