Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXAuthenticatedUser

The IFWXAuthenticatedUser interface represents a single authenticated user. This may be a Windows user or a non-Windows user. The IFWXAuthenticatedUser interface inherits from the IFWXImpersonator interface.

The IFWXAuthenticatedUser interface is the product of asynchronous firewall authentication, and is returned by IFWXAuthenticationCompletion::CompleteAsyncAuthentication. For example, if the authentication completion results from a call to the IFWXRadiusAuthenticator::AuthenticateRadiusUser, IFWXAuthenticatedUser will represent a RADIUS authenticated user.

Methods in Vtable Order

The IFWXAuthenticatedUser interface inherits the methods of the standard COM interface IUnknown.

In addition, IFWXAuthenticatedUser defines the following methods, including those inherited from IFWXImpersonator.

Method Description
Impersonate Impersonates the Windows user's account. For non-Windows users, this method does not perform any actual impersonation; it returns S_OK.
RevertToSelf Undoes impersonation for a Windows user. For non-Windows users, this method does not undo impersonation; it returns S_OK.

Properties

The IFWXAuthenticatedUser interface has the following properties.

Property Description
Namespace Gets the namespace of the authentication scheme for the user.
UserGroups Gets a semicolon delimited string detailing the groups to which the user belongs. This information may not always be available, and is specifically unavailable for Windows users.
Username Gets the name of the authenticated user.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

Filter Interfaces