Applies to: desktop apps only
The CreateRadiusAuthenticator method creates a RADIUS authenticator interface (IFWXRadiusAuthenticator), which can be used to authenticate RADIUS users.
HRESULT CreateRadiusAuthenticator( [out] IFWXRadiusAuthenticator **ppIFWXRadiusAuthenticator );
- ppIFWXRadiusAuthenticator [out]
Address of an interface pointer that on return points to the new IFWXRadiusAuthenticator interface created.
This method returns S_OK if the call is successful; otherwise, it returns an error code.
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.
Minimum supported client
Minimum supported server
|Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)|
|Forefront Threat Management Gateway (TMG) 2010|
Build date: 7/12/2010