Click to Rate and Give Feedback
MSDN
MSDN Library
COM+ Reference
 Components

  Switch on low bandwidth view
COM+ (Component Services)
Components

The Components collection is always related to an object in the Applications collection. It holds an object for each component in the related application. The properties exposed by these objects hold settings made at the component level.

ms688285.note(en-us,VS.85).gifNote:
You assign roles to a component by using the related RolesForComponent collection, and you can examine the interfaces exposed by a component by using the related InterfacesForComponent collection.

The Components collection supports the Remove method but not the Add method on the COMAdminCatalogCollection object. To install or import components into an application, use methods on the COMAdminCatalog object.

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

You can navigate to the Components collection from the following collection:

Enables in process subscribers if the component is an event class.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

The GUID for the application containing the component. Must be a valid application's GUID, which is verified before SaveChanges is called. If this value is changed to be a GUID for a different application, the component moves to that application.

Access:

ReadWrite

Type:

String

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Represents the binary bitness type of a component. On systems that use 64-bit Windows, this property distinguishes between 64-bit components and 32-bit components.

Access:

ReadOnly

Type:

Long

Enum:

COMAdmin32BitComponent = 0x1

COMAdmin64BitComponent = 0x2

Default:

N/A

Platform Requirements:

Windows XP, Windows Server 2003

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

Access:

ReadOnly

Type:

String

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether role-based access checks are performed on calls into the component and works in conjunction with the AccessChecksLevel and ApplicationAccessChecksEnabled properties on the application.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

When used in a transaction, specifies the time period in which this component causes the transaction to time out. The default is 60 seconds and cannot be longer than 3600 seconds (1 hour). The time-out value can be set to 0, specifying an infinite transaction time-out period. For this property to be used, ComponentTransactionTimeoutEnabled must be True. The value of this property overrides the global transaction time-out specified by the TransactionTimeout property of the LocalComputer collection.

Access:

ReadWrite

Type:

Long

Values:

0-3600

Default:

60

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Specifies whether the transaction time-out period is enabled for this component. By default, the transaction time-out feature is disabled. When this property is True, the time-out specified by ComponentTransactionTimeout is used. When this property is False, the time-out specified by the TransactionTimeout property of the LocalComputer collection is used.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Enables passing of context properties from the COM Transaction Integrator (COMTI) into the context for this class. The COMTI eases the task of wrapping mainframe transactions and business logic as COM components.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines whether the ConstructorString is passed to the object when it is constructed.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Initialization string for component construction. You can create different objects from the same generic component by using object constructor strings. If ConstructionEnabled is False, this property is ignored.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

When creating the object, number of milliseconds before a time-out error is returned. The maximum time-out is 2147483647 milliseconds (about 25 days).

Access:

ReadWrite

Type:

Long

Values:

0 – 2147483647

Default:

0

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Describes the component.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

The name and path of the file containing the component.

Access:

ReadOnly

Type:

String

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines whether events are tracked. Events include actions such as application shutdown; object creation and release; object references, consistency, activation, and deactivation; method calls, returns, and exceptions; transaction startup, preparing to commit, and abort; resource dispenser connection, allocation, and recycling; thread allocation and recycling.

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

The CLSID, which can be a GUID or a moniker string, to activate an alternative program during the process of dealing with a repeatedly failing Queued Components program.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Enables events to be fired in parallel if the component is an event class.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Enables passing of IIS context properties, such as an application session object or a user session object, into the context for this class.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether the component is used to initialize a server application.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows Server 2003

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

Access:

ReadWrite

Type:

Bool

Default:

True

Platform Requirements:

Windows XP, Windows Server 2003

Indicates whether the component is an event class.

Access:

ReadOnly

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates whether the component is installed in an application.

Access:

ReadOnly

Type:

Bool

Default:

False

Platform Requirements:

Windows Server 2003

Determines whether a server application is a private component. A private component in a server application can be activated only from within the application. For example, if you call CoCreateInstance on a private component, it fails from out-of-process but succeeds in-process. In contrast, if you call CoCreateInstance on a public component, it succeeds both in-process and out-of-process.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

Determines whether JIT Activation is enabled for the component. This property is set to True when Transaction support is set to Required, Requires New, or Supported. When JustInTimeActivation is set to True, Synchronization support must be set to Required (the default) or Requires New.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

If the component load balancing service is installed and enabled on the server, determines whether the component participates in load balancing.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Maximum number of objects pooled.

Access:

ReadWrite

Type:

Long

Values:

1 - 1048576

Default:

1048576

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Minimum number of objects pooled.

Access:

ReadWrite

Type:

Long

Values:

0 – 1048576

Default:

0

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

CLSID for the publisher filter used if the component is an event class.

Access:

ReadWrite

Type:

String

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates that component must be activated in its original caller's context. Otherwise, activation fails.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates that the component must be activated in the default caller's context. Otherwise, activation fails.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows XP, Windows Server 2003

Determines whether COM+ Object Pooling is enabled for the component.

Access:

ReadWrite

Type:

Bool

Default:

False

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A friendly name used for identifying the component. This property is returned when the Name property method is called on an object of this collection.

Access:

ReadOnly

Type:

String

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Identifier for the event publisher if the component is an event class.

Access:

ReadWrite

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

A GUID identifying the GAC assembly that is run when the component is invoked as a SOAP service.

Access:

ReadWrite

Type:

String

Default:

NULL

Platform Requirements:

Windows Server 2003

The managed type name for a component that can be invoked as a SOAP service.

Access:

ReadWrite

Type:

String

Default:

NULL

Platform Requirements:

Windows Server 2003

Determines call synchronization for the component.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminSynchronizationIgnored = 0

COMAdminSynchronizationNone = 1

COMAdminSynchronizationSupported = 2

COMAdminSynchronizationRequired = 3

COMAdminSynchronizationRequiresNew = 4

Default:

COMAdminSynchronizationIgnored

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines how instances of the component are assigned to threads for method execution. Values correspond to COM threading models.

Access:

ReadOnly

Type:

Long

Enum:

COMAdminThreadingModelApartment = 0

COMAdminThreadingModelFree = 1

COMAdminThreadingModelMain = 2

COMAdminThreadingModelBoth = 3

COMAdminThreadingModelNeutral = 4

COMAdminThreadingModelNotSpecified = 5

Default:

N/A

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Determines how a component supports transactions. It is recommended that you use the constants in the enumeration and not the numeric values.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminTransactionIgnored = 0

COMAdminTransactionNone = 1

COMAdminTransactionSupported = 2

COMAdminTransactionRequired = 3

COMAdminTransactionRequiresNew = 4

Default:

COMAdminTransactionNone

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Indicates the transaction isolation levels. There are five isolation levels: none, read uncommitted, read committed, repeatable read, and serialized. The default isolation level is serialized.

Access:

ReadWrite

Type:

Long

Enum:

COMAdminTxIsolationLevelAny = 0

COMAdminTxIsolationLevelReadUnCommitted = 1

COMAdminTxIsolationLevelReadCommitted = 2

COMAdminTxIsolationLevelRepeatableRead = 3

COMAdminTxIsolationLevelSerializable = 4

Default:

COMAdminTxIsolationLevelSerializable

Platform Requirements:

Windows XP, Windows Server 2003

Version build identifier.

Access:

ReadOnly

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Version identifier.

Access:

ReadOnly

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Version sub-identifier.

Access:

ReadOnly

Type:

String

Default:

""

Platform Requirements:

Windows 2000, Windows XP, Windows Server 2003

Version sub-build identifier.

Access:

ReadOnly

Type:

String

Default:

""

Platform Requirements:

Windows 2000, 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
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker