HRESULT CreateRadiusAuthenticator( [out] IFWXRadiusAuthenticator** ppIFWXRadiusAuthenticator );
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.
|Server||Requires Windows Server 2008.|
|Version||Requires Forefront Threat Management Gateway (TMG).|
Declared in Wspfwext.idl.
Build date: 11/30/2009
© 2008 Microsoft Corporation. All rights reserved.