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.

Syntax

interface IFWXAuthenticatedUser : IFWXImpersonator

Methods

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.

Properties

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.

Requirements

Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
Header

Declared in Wspfwext.idl.

See Also

Filter Interfaces


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.