Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXRadiusAuthenticator::AuthenticateRadiusUser

The AuthenticateRadiusUser method performs RADIUS authentication of the specified user in an asynchronous operation.

HRESULT AuthenticateRadiusUser(
  BSTR bstrUsername,
  BSTR bstrUserPassword,
  IFWXAuthenticationCompletion* pIFWXAuthenticationCompletion,
  UserContextType UserData
);

Parameters

bstrUsername
[in] String value that specifies the user name with which to perform authentication.
bstrUserPassword
[in] String value that specifies the user password with which to perform authentication.
pIFWXAuthenticationCompletion
[in] A pointer to an IFWXAuthenticationCompletion interface.
UserData
[in] An opaque value which you can use to differentiate between authentication operations. This value will be passed in the UserData parameter of the CompleteAsyncAuthentication method on the IFWXAuthenticationCompletion interface specified in the pIFWXAuthenticationCompletion parameter when this authentication operation completes.

Return Values

This method returns S_OK or ERROR_IO_PENDING if the call is successful; otherwise, it returns a Windows error code, in which case the authentication operation is not initiated and the completion function will not be called.

Remarks

An application filter can use IFWXFirewall2::CreateRadiusAuthenticator 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 the pointer to its IFWXAuthenticationCompletion 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

IFWXRadiusAuthenticator