CreateRadiusAuthenticator Method of the IFWXFirewall2 Interface
The CreateRadiusAuthenticator method creates a RADIUS authenticator interface (IFWXRadiusAuthenticator), which can be used to authenticate RADIUS users.
Syntax
HRESULT CreateRadiusAuthenticator(
[out] IFWXRadiusAuthenticator** ppIFWXRadiusAuthenticator
);
Parameters
- ppIFWXRadiusAuthenticator
Address of an interface pointer that on return points to the new IFWXRadiusAuthenticator interface created.
Return Value
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 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
Header | Declared in Wspfwext.idl. |
DLL | Requires Wspsrv.exe. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010