HostingEnvironment.Impersonate Method (IntPtr, String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.

Namespace:   System.Web.Hosting
Assembly:  System.Web (in System.Web.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
public static IDisposable Impersonate(
	IntPtr userToken,
	string virtualPath


Type: System.IntPtr

The handle of a Windows account token.

Type: System.String

The path to the requested resource.

Return Value

Type: System.IDisposable

An IDisposable object that represents the Windows user prior to impersonation; this object can be used to revert to the original user's context.

Exception Condition

The process cannot impersonate.

The Impersonate method impersonates the user that results after applying all elements in the configuration settings affecting the specified virtual path. If an identity element is not specified for the virtual path, the Impersonate method impersonates the specified Windows account.

.NET Framework
Available since 2.0
Return to top