IFWXAuthenticatedUser Interface

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.

interface IFWXAuthenticatedUser : IFWXImpersonator

The IFWXAuthenticatedUser interface inherits from IFWXImpersonator.

In addition, IFWXAuthenticatedUser defines the following methods.

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.

The IFWXAuthenticatedUser interface defines 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.

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.