IFWXFirewall2::CreateRadiusAuthenticator method

Applies to: desktop apps only

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 [out]
  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

See also

IFWXFirewall2

Build date: 7/12/2010