HostProtectionResource Enumeration (System.Security.Permissions)

HostProtectionResource Enumeration

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

HostProtectionResource Enumeration

Specifies categories of functionality potentially harmful to the host if invoked by a method or class.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

Visual Basic (Declaration)

<SerializableAttribute> _
<FlagsAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration HostProtectionResource

Visual Basic (Usage)

Dim instance As HostProtectionResource

[SerializableAttribute]
[FlagsAttribute]
[ComVisibleAttribute(true)]
public enum HostProtectionResource

Visual C++

[SerializableAttribute]
[FlagsAttribute]
[ComVisibleAttribute(true)]
public enum class HostProtectionResource

JScript

public enum HostProtectionResource

Members

	Member name	Description
	None	Exposes no host resources.
	Synchronization	Exposes synchronization.
	SharedState	Exposes state that might be shared between threads.
	ExternalProcessMgmt	Might create or destroy other processes.
	SelfAffectingProcessMgmt	Might exit the current process, terminating the server.
	ExternalThreading	Creates or manipulates threads other than its own, which might be harmful to the host.
	SelfAffectingThreading	Manipulates threads in a way that only affects user code.
	SecurityInfrastructure	Exposes the security infrastructure.
	UI	Exposes the user interface.
	MayLeakOnAbort	Might cause a resource leak on termination, if not protected by a safe handle or some other means of ensuring the release of resources.
	All	Exposes all host resources.

Remarks

This enumeration is used by the HostProtectionAttribute attribute.

Examples

The following code example shows the use of the HostProtectionResource enumeration with the HostProtectionAttribute attribute. This example is part of a larger example provided for the HostProtectionAttribute class.

Visual Basic

' Use the enumeration flags to indicate that this method exposes 
' shared state and self-affecting process management.
' Either of the following attribute statements can be used to set the 
' resource flags.
<HostProtectionAttribute(SharedState := True, _
    SelfAffectingProcessMgmt := True), _
    HostProtectionAttribute( _
    Resources := HostProtectionResource.SharedState Or _
    HostProtectionResource.SelfAffectingProcessMgmt)> _
Private Shared Sub [Exit](ByVal Message As String, ByVal Code As Integer)

    ' Exit the sample when an exception is thrown.
    Console.WriteLine((ControlChars.Lf & "FAILED: " & Message & " " & _
        Code.ToString()))
    Environment.ExitCode = Code
    Environment.Exit(Code)
End Sub 'Exit

// Use the enumeration flags to indicate that this method exposes 
// shared state and self-affecting process management.
// Either of the following attribute statements can be used to set the
// resource flags.
[HostProtectionAttribute(SharedState = true, 
    SelfAffectingProcessMgmt = true)]
[HostProtectionAttribute(Resources = HostProtectionResource.SharedState |
     HostProtectionResource.SelfAffectingProcessMgmt)]
private static void Exit(string Message, int Code)
{
    // Exit the sample when an exception is thrown.
    Console.WriteLine("\nFAILED: " + Message + " " + Code.ToString());
    Environment.ExitCode = Code;
    Environment.Exit(Code);
}

Visual C++

// Use the enumeration flags to indicate that this method exposes shared state and 
// self-affecting process management.
// Either of the following attribute statements can be used to set the 
// resource flags.
// Exit the sample when an exception is thrown.

[HostProtection(SharedState=true,SelfAffectingProcessMgmt=true)]
[HostProtection(Resources=HostProtectionResource::SharedState|
HostProtectionResource::SelfAffectingProcessMgmt)]
static void Exit( String^ Message, int Code )
{
   Console::WriteLine( "\nFAILED: {0} {1}", Message, Code );
   Environment::ExitCode = Code;
   Environment::Exit( Code );
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

System.Security.Permissions Namespace