This documentation is archived and is not being maintained.

SecurityManager.PolicyHierarchy Method

Note: This API is now obsolete.

Provides an enumerator to access the security policy hierarchy by levels, such as computer policy and user policy.

Namespace:  System.Security
Assembly:  mscorlib (in mscorlib.dll)

[ObsoleteAttribute("This method is obsolete and will be removed in a future release of the .NET Framework. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static IEnumerator PolicyHierarchy()

Return Value

Type: System.Collections.IEnumerator
An enumerator for PolicyLevel objects that compose the security policy hierarchy.

ExceptionCondition
NotSupportedException

This method uses code access security (CAS) policy, which is obsolete in the .NET Framework version 4. To enable CAS policy for compatibility with earlier versions of the .NET Framework, use the <legacyCasPolicy> element.<NetFx40_LegacySecurityPolicy> Element.

SecurityException

The code that calls this method does not have SecurityPermissionFlag.ControlPolicy.

The returned enumerator provides successive PolicyLevel objects that represent the policy at the respective (machine, user, enterprise, application domain) level of the hierarchy. These objects are the live policy objects; altering these objects can have unpredictable results.

Minimum policy hierarchy consists of a machine level, an enterprise level, and a user level. However, the hierarchy can include additional levels.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Obsolete (compiler warning) in 4

.NET Framework Client Profile

Supported in: 3.5 SP1
Obsolete (compiler warning) in 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: