STARTUP_FLAGS Enumeration

Contains values that indicate the startup behavior of the common language runtime (CLR). By default, garbage collection is non-concurrent, and only the base class library is loaded into the domain-neutral area.

typedef enum {
    STARTUP_CONCURRENT_GC                         = 0x1,
    STARTUP_LOADER_OPTIMIZATION_MASK              = 0x3<<1,
    STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN     = 0x1<<1,
    STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN      = 0x2<<1,
    STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST = 0x3<<1,

    STARTUP_LOADER_SAFEMODE                       = 0x10,
    STARTUP_LOADER_SETPREFERENCE                  = 0x100,

    STARTUP_SERVER_GC                             = 0x1000,
    STARTUP_HOARD_GC_VM                           = 0x2000,

    STARTUP_SINGLE_VERSION_HOSTING_INTERFACE      = 0x4000,
    STARTUP_LEGACY_IMPERSONATION                  = 0x10000,
    STARTUP_DISABLE_COMMITTHREADSTACK             = 0x20000,
    STARTUP_ALWAYSFLOW_IMPERSONATION              = 0x40000,
    STARTUP_TRIM_GC_COMMIT                        = 0x80000,

    STARTUP_ETW                                   = 0x100000,
    STARTUP_ARM                                   = 0x400000
} STARTUP_FLAGS;

Members

Member

Description

STARTUP_CONCURRENT_GC

Specifies that concurrent garbage collection should be used. If the caller asks for the server build and concurrent garbage collection on a single-processor machine, the workstation build and non-concurrent garbage collection are run instead.

Note

Concurrent garbage collection is not supported in applications that are running the WOW64 x86 emulator on 64-bit systems that implement the Intel Itanium architecture (formerly called IA-64). For more information about using WOW64 on 64-bit Windows systems, see Running 32-bit Applications.

STARTUP_LOADER_OPTIMIZATION_MASK

Specifies that loader optimization shall occur.

STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN

Specifies that no assemblies are loaded as domain-neutral.

STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN

Specifies that all assemblies are loaded as domain-neutral.

STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST

Specifies that all strong-named assemblies are loaded as domain-neutral.

STARTUP_LOADER_SAFEMODE

Specifies that CLR version policy will not be applied to the version passed in. The exact version specified of the CLR will be loaded. The shim does not evaluate policy to determine the latest compatible version.

STARTUP_LOADER_SETPREFERENCE

Specifies that the preferred runtime will be set, but not actually started.

STARTUP_SERVER_GC

Specifies that the server garbage collection will be used.

STARTUP_HOARD_GC_VM

Specifies that garbage collection will keep the virtual address used.

STARTUP_SINGLE_VERSION_HOSTING_INTERFACE

Specifies that mixing a hosting interface will not be allowed.

STARTUP_LEGACY_IMPERSONATION

Specifies that impersonation should not flow across asynchronous points by default.

STARTUP_DISABLE_COMMITTHREADSTACK

Specifies that the full thread stack should not be committed when the thread starts running.

STARTUP_ALWAYSFLOW_IMPERSONATION

Specifies that managed impersonations and impersonations achieved through platform invoke will flow across asynchronous points. By default, only managed impersonations will flow across asynchronous points.

STARTUP_TRIM_GC_COMMIT

Specifies that garbage collection will use less committed space when system memory is low. See gcTrimCommitOnLowMemory in Optimization for Shared Web Hosting.

STARTUP_ETW

Specifies that event tracing for Windows (ETW) is enabled for common language runtime events. Beginning with Windows Vista, event tracing is always enabled, so this flag has no effect. See Controlling .NET Framework Logging.

STARTUP_ARM

Specifies that application domain resource monitoring is enabled. See the AppDomain.MonitoringIsEnabled property and <appDomainResourceMonitoring> Element.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.h

Library: MSCorEE.dll

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Other Resources

Hosting Enumerations