Click to Rate and Give Feedback
MSDN
MSDN Library
COM+ Reference
 Applications (COM+)
COM+ (Component Services)
Applications (COM+)

The Applications collection is a top-level collection. It contains an object for each COM+ application installed on the local computer. The properties exposed by these objects hold all settings made at the application level.

You set properties for components within an application by using the related Components collection. You assign roles to an application by using the related Roles collection.

To install components into an application, use methods on the COMAdminCatalog object. To install an application from a file or to shut down or export an application, also use methods on the COMAdminCatalog object. Otherwise, to create a new application, you can add an object to the Applications collection.

The Applications collection supports the Add and Remove methods on the COMAdminCatalogCollection object.

You can navigate to any of the following collections from the Applications collection:

You can navigate to the Applications collection from the following collections:

Indicates whether the application can use 3 GB of memory in its process. If this is not enabled, the application can use only 2 GB of memory.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether access checks are performed at only the process level or at both the process and component level. It is recommended that you use the constants in the enumeration and not the numeric values.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminAccessChecksApplicationLevel = 0

COMAdminAccessChecksApplicationComponentLevel = 1

Default:

COMAdminAccessChecksApplicationComponentLevel

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Local activation indicates that objects within the application run within a dedicated local server process (server application). In-process activation indicates that objects run in their creator's process (library application).

Access:

ReadWrite

Type:

Long

Enum

COMAdminActivationInproc = 0

COMAdminActivationLocal = 1

Default:

COMAdminActivationLocal = 1

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether access checks are performed for the application when clients make calls into it.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

The full path to the application. This information is needed when you configure Side-by-Side (SxS) assemblies. Side-by-side (SxS) assemblies allow ASP applications to specify which version of an SxS-supported system DLL to use, such as MSVCRT, MSXML, COMCTL, GDIPLUS, and so on. For example, if your ASP application relies on MSVCRT version 2.0, you can ensure that your application still uses MSVCRT version 2.0 even after service packs are applied to the server. Any new version of MSVCRT is still installed on the computer, but version 2.0 remains and is used by your application. SxS-supported DLLs are stored in %WINDIR%\WinSxS.

ms686107.note(en-us,VS.85).gifNote:
Only one version of a system DLL can be used in any application pool, even though this feature is configurable at the application level. For example, if application App1 uses MSVCRT, version 2.5 and application App2 uses MSVCRT, version 2.4, then App1 and App2 should not be in the same application pool. If they are, the application that is loaded first has its version of MSVCRT loaded, and the other application is forced to use it until the applications are unloaded.

For more information, see "Side-by-Side Assemblies" in Changes in COM+ Services in IIS 6.0.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows XP, Windows Server 2003

Indicates whether the application is an application proxy.

Access:

ReadOnly

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A remote server name used when exporting the application proxy. It is this server name that the application proxy points to when it is installed on a client computer.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A GUID representing the application partition ID.

Access:

ReadOnly

Type:

String

Default:

<Generated>

Platform Requirements:

Windows Server 2003

Sets authentication level for calls, with values corresponding to the Remote Procedure Call (RPC) authentication settings. When COMAdminAuthenticationDefault is chosen, the setting in the DefaultAuthenticationLevel property on the COMAdminCatalogObject object within the LocalComputer collection is used.

ms686107.note(en-us,VS.85).gifNote:
For library (in-process) applications, the only valid settings here are Default and None. It is recommended that you use the constants in the enumeration and not the numeric values.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminAuthenticationDefault = 0

COMAdminAuthenticationNone = 1

COMAdminAuthenticationConnect = 2

COMAdminAuthenticationCall = 3

COMAdminAuthenticationPacket = 4

COMAdminAuthenticationIntegrity = 5

COMAdminAuthenticationPrivacy = 6

Default:

COMAdminAuthenticationPacket

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines what identity is presented when calls are impersonated.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminAuthenticationCapabilitiesNone = 0x0

COMAdminAuthenticationCapabilitiesSecureReference = 0x02

COMAdminAuthenticationCapabilitiesStaticCloaking = 0x20

COMAdminAuthenticationCapabilitiesDynamicCloaking = 0x40

Default:

COMAdminAuthenticationCapabilitiesDynamicCloaking

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines whether changes to the application settings or those of its components are allowed, either programmatically or through the Component Services administration tool.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A command-line string for use in debugging. The application can be launched in a debugger with the specified command line.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Specifies the maximum number of poolable applications that can run concurrently.

Access:

ReadWrite

Type:

Long

Values:

1 - 1048576

Default:

1

Platform Requirements:

Windows XP, Windows Server 2003

Informational string to describe who created the application.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines whether the Compensating Resource Manager is enabled.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Name and path of file for keeping the log for the compensating resource manager (CRM).

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Sets whether the application can be deleted, either programmatically or through the Component Services administration tool.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Describes the application.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Enables the dump of the state of a COM+ application at the time of failure to a designated directory.

ms686107.note(en-us,VS.85).gifNote:
As of Microsoft Windows Server 2003, only administrators have read access privileges to the COM+ dump files.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

Enables the dump of the state of a COM+ application when the application causes an unhandled exception and is terminated by the COM+ runtime.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

Enables the dump of the state of a COM+ application when the application fails.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

The path of the directory in which the dump files are saved.

ms686107.note(en-us,VS.85).gifNote:
As of Microsoft Windows Server 2003, only administrators have read access privileges to the COM+ dump files.

Access:

ReadWrite

Type:

String

Default:

"%systemroot%\system32\com\dmp"

Platform Requirements:

Windows XP, Windows Server 2003

Indicates whether events are enabled for the application.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A GUID representing the application. This property is returned when the Key property method is called on an object of this collection.

ms686107.note(en-us,VS.85).gifNote:
Properties with WriteOnce access are ReadWrite while using the Add method prior to using SaveChanges and are ReadOnly afterward.

Access:

WriteOnce

Type:

String

Default:

<Generated>

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Sets the server process identity for the application. Specify a valid user account or "Interactive User" to have the application assume the identity of the current logged-on user. As of Windows Server 2003, you can also specify the strings "nt authority\localservice" (for Local Service), "nt authority\networkservice" (for Network Service), and "nt authority\system" (for Local System). The default password for these three options is "" (empty string).

The Identity property is not enabled for library applications, which run in the client process.

ms686107.note(en-us,VS.85).gifNote:
The Password property should be set at the same time as Identity, prior to using SaveChanges, because the password and identity are validated before being saved. If the password and identity get out of sync, the application cannot be launched until they are reset by an administrator.

Access:

ReadWrite

Type:

String

Default:

"Interactive User"

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Sets impersonation level used for calls made to other applications.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminImpersonationAnonymous = 1

COMAdminImpersonationIdentify = 2

COMAdminImpersonationImpersonate = 3

COMAdminImpersonationDelegate = 4

Default:

COMAdminImpersonationImpersonate

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

If the COM+ application or component is disabled, IsEnabled is False. If the COM+ application or component is enabled, IsEnabled is True.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows XP, Windows Server 2003

Identifies COM+ system applications.

Access:

ReadOnly

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates the maximum number of files to be generated before overwriting occurs.

Access:

ReadWrite

Type:

Long

Values:

1 - 200

Default:

5

Platform Requirements:

Windows XP, Windows Server 2003

The name of the application. Extra spaces at the beginning and end of the string are stripped out. This property is returned when the Name property method is called on an object of this collection.

Unique names should be chosen for applications. If multiple applications are created with the same name, it can interfere with referencing the applications by name, resulting in unpredictable behavior.

Access:

ReadWrite

Type:

String

Default:

"New Application"

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Sets the password used by the server process to log on under the identity.

ms686107.note(en-us,VS.85).gifNote:
Password should be set at the same time as Identity, prior to using SaveChanges, because the password and identity are validated before being saved. If the password and identity get out of sync, the application cannot be launched until they are reset by an administrator.

Access:

WriteOnly

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates under what circumstances queued requests to an application are authenticated.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminQCMessageAuthenticateSecureApps = 0

COMAdminQCMessageAuthenticateOff = 1

COMAdminQCMessageAuthenticateOn = 2

Default:

COMAdminQCMessageAuthenticateSecureApps

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the maximum number of concurrent listener threads. The valid range for this property is 0 to 1000. For a newly created application, the setting is derived from the algorithm currently used for determining the default number of listener threads: 16 times the number of CPUs in the server.

This property is also available with read/write capability from the Queuing tab of the Component Services administrative tool's property pages.

ms686107.note(en-us,VS.85).gifNote:
COM+ no longer reads the following registry key: HKLM\Software\Microsoft\COM3\Debug\QCListenerMaxThread.

Access:

ReadWrite

Type:

Long

Values:

0 – 1000

Default:

0

Platform Requirements:

Windows XP, Windows Server 2003

Indicates whether the Queued Components listener is enabled for the application. If enabled, the listener is launched when the application starts. This property takes effect only if QueuingEnabled is set to True.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether the COM+ Queued Components service is enabled for the application.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates the maximum number of activations of configured objects in the application to accept before recycling the process. The default number of activations is 0.

Access:

ReadWrite

Type:

Long

Values:

0 - 1048576

Default:

0

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the maximum number of calls to allow configured objects in the application to accept before recycling the process. The default number of calls is 0.

Access:

ReadWrite

Type:

Long

Values:

0 - 1048576

Default:

0

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the amount of time (in minutes) to allow a recycled process to run before shutting it down. The countdown begins immediately after the process is recycled. The maximum expiration time-out is 1440 minutes (24 hours), and the default is 15 minutes.

Access:

ReadWrite

Type:

Long

Values:

1 - 1440

Default:

15

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the maximum number of minutes to allow a process to run before recycling it. The maximum lifetime limit is 30240 minutes (21 days), and the default is 0 minutes.

Access:

ReadWrite

Type:

Long

Values:

0 - 30240

Default:

0

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the maximum amount of memory usage (in kilobytes) allowed a process before it's recycled. If the process memory usage exceeds the specified number for a period longer than one minute, the process is recycled. The default amount of memory usage is 0 KB.

Access:

ReadWrite

Type:

Long

Values:

0 - 1048576

Default:

0

Platform Requirements:

Windows XP, Windows Server 2003

Indicates whether the application can be replicated.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows XP, Windows Server 2003

Enables a server process to continue if an application is idle. If set to True, the server process does not shut down when left idle. If set to False, the process shuts down according to the value set by the ShutdownAfter property. RunForever is not enabled for library (in-process) applications.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

The service name corresponding to the application configured to run as an NT service. If this value is NULL, the application is not configured to run as an NT service. Otherwise, the configuration information for the service can be found by using the service name.

Access:

ReadOnly

Type:

String

Default:

""

Platform Requirements:

Windows XP, Windows Server 2003

Sets the delay before shutting down a server process after it becomes idle. Shutdown latency ranges from 0 to 1440 minutes (24 hours). If RunForever is set to True, this property is ignored. ShutdownAfter is not enabled for library (in-process) applications.

Access:

ReadWrite

Type:

Long

Values:

0-1440

Default:

3

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether this application is exposed for consumption via the SOAP protocol.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows Server 2003

The URL endpoint at which this application is exposed via the SOAP protocol.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows Server 2003

The e-mail address at which this application is exposed via the SOAP protocol.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows Server 2003

The IIS virtual root directory in which the access scripts that expose the application via the SOAP protocol reside.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows Server 2003

Determines the software restriction policy (SRP) for the application. If set to True, the SRPTrustLevel property for the application is used. If set to False, the software restriction policies from the local security settings are used. The local security settings are controlled through the Local Security Policy snap-in of the Microsoft Management Console.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

Indicates the software restriction policy (SRP) trust level of the application. This property is used only if the SRPEnabled property is set to True. The SRP trust level refers to the level of trust that you are willing to give to an application. An Unrestricted SRP trust level corresponds to the SAFER_LEVELID_FULLYTRUSTED enum value, while a Disallowed SRP trust level corresponds to the SAFER_LEVELID_DISALLOWED enum value. The enumeration for the trust levels is defined in winsafer.h.

An application that you are willing to trust with Unrestricted access should have the most stringent security attached to it. Applications that are Unrestricted can load only unrestricted components, while Disallowed applications will not be allowed to run and therefore cannot load any components.

Access:

ReadWrite

Type:

Long

Enum:

SAFER_LEVELID_DISALLOWED = 0x0

SAFER_LEVELID_FULLYTRUSTED = 0x40000

Default:

SAFER_LEVELID_FULLYTRUSTED

Platform Requirements:

Windows XP, Windows Server 2003

Send comments about this topic to Microsoft.
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2008 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker