Export (0) Print
Expand All
3 out of 4 rated this helpful - Rate this topic

Components collection

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

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

Members

The Components collection inherits from the IUnknown interface but does not have additional members.

Related Collections

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

You can navigate to this collection from the following collections:

Properties

The following properties are supported by the COMAdminCatalogObject object within the collection:

AllowInprocSubscribers

DescriptionEnables in process subscribers if the component is an event class.
AccessReadWrite
TypeBool
DefaultTrue
Minimum systemWindows 2000

 

ApplicationID

DescriptionThe 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.
AccessReadWrite
TypeString
DefaultN/A
Minimum systemWindows 2000

 

Bitness

DescriptionRepresents 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.
AccessReadOnly
TypeLongPossible values:COMAdmin32BitComponent (0x1)COMAdmin64BitComponent (0x2)
DefaultN/A
Minimum systemWindows XP

 

CLSID

DescriptionA GUID for the component. This property is returned when the Key property method is called on an object of this collection.
AccessReadOnly
TypeString
DefaultN/A
Minimum systemWindows 2000

 

ComponentAccessChecksEnabled

DescriptionIndicates 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.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

ComponentTransactionTimeout

DescriptionWhen 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.
AccessReadWrite
TypeLong (0-3600)
Default60
Minimum systemWindows 2000

 

ComponentTransactionTimeoutEnabled

DescriptionSpecifies 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.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

COMTIIntrinsics

DescriptionEnables 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.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

ConstructionEnabled

DescriptionDetermines whether the ConstructorString is passed to the object when it is constructed.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

ConstructorString

DescriptionInitialization 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.
AccessReadWrite
TypeString
Default""
Minimum systemWindows 2000

 

CreationTimeout

DescriptionWhen creating the object, number of milliseconds before a time-out error is returned. The maximum time-out is 2147483647 milliseconds (about 25 days).
AccessReadWrite
TypeLong (0-2147483647)
Default0
Minimum systemWindows 2000

 

Description

DescriptionDescribes the component.
AccessReadWrite
TypeString
Default""
Minimum systemWindows 2000

 

DLL

DescriptionThe name and path of the file containing the component.
AccessReadOnly
TypeString
DefaultN/A
Minimum systemWindows 2000

 

EventTrackingEnabled

DescriptionDetermines 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.
AccessReadWrite
TypeBool
DefaultTrue
Minimum systemWindows 2000

 

ExceptionClass

DescriptionThe 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.
AccessReadWrite
TypeString
Default""
Minimum systemWindows 2000

 

FireInParallel

DescriptionEnables events to be fired in parallel if the component is an event class.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

IISIntrinsics

DescriptionEnables passing of IIS context properties, such as an application session object or a user session object, into the context for this class.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

InitializeServerApplication

DescriptionIndicates whether the component is used to initialize a server application.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows Server 2003

 

IsEnabled

DescriptionFalse if the COM+ application or component is disabled. If the COM+ application or component is enabled, IsEnabled is True.
AccessReadWrite
TypeBool
DefaultTrue
Minimum systemWindows XP

 

IsEventClass

DescriptionIndicates whether the component is an event class.
AccessReadOnly
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

IsInstalled

DescriptionIndicates whether the component is installed in an application.
AccessReadOnly
TypeBool
DefaultFalse
Minimum systemWindows Server 2003

 

IsPrivateComponent

DescriptionDetermines 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.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows XP

 

JustInTimeActivation

DescriptionDetermines 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.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

LoadBalancingSupported

DescriptionIf the component load balancing service is installed and enabled on the server, determines whether the component participates in load balancing.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

MaxPoolSize

DescriptionMaximum number of objects pooled.
AccessReadWrite
TypeLong (1-1048576)
Default1048576
Minimum systemWindows 2000

 

MinPoolSize

DescriptionMinimum number of objects pooled.
AccessReadWrite
TypeLong (0-1048576)
Default0
Minimum systemWindows 2000

 

MultiInterfacePublisherFilterCLSID

DescriptionCLSID for the publisher filter used if the component is an event class.
AccessReadWrite
TypeString
DefaultN/A
Minimum systemWindows 2000

 

MustRunInClientContext

DescriptionIndicates that component must be activated in its original caller's context. Otherwise, activation fails.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows XP

 

MustRunInDefaultContext

DescriptionIndicates that the component must be activated in the default caller's context. Otherwise, activation fails.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

ObjectPoolingEnabled

DescriptionDetermines whether COM+ object pooling is enabled for the component.
AccessReadWrite
TypeBool
DefaultFalse
Minimum systemWindows 2000

 

ProgID

DescriptionA friendly name used for identifying the component. This property is returned when the Name property method is called on an object of this collection.
AccessReadOnly
TypeString
DefaultN/A
Minimum systemWindows 2000

 

PublisherID

DescriptionIdentifier for the event publisher if the component is an event class.
AccessReadWrite
TypeString
Default""
Minimum systemWindows 2000

 

SoapAssemblyName

DescriptionA GUID identifying the GAC assembly that is run when the component is invoked as a SOAP service.
AccessReadWrite
TypeString
DefaultNULL
Minimum systemWindows Server 2003

 

SoapTypeName

DescriptionThe managed type name for a component that can be invoked as a SOAP service.
AccessReadWrite
TypeString
DefaultNULL
Minimum systemWindows Server 2003

 

Synchronization

DescriptionDetermines call synchronization for the component.
AccessReadWrite
TypeLongPossible values:COMAdminSynchronizationIgnored (0)COMAdminSynchronizationNone (1)COMAdminSynchronizationSupported (2)COMAdminSynchronizationRequired (3)COMAdminSynchronizationRequiresNew (4)
DefaultCOMAdminSynchronizationIgnored (0)
Minimum systemWindows 2000

 

ThreadingModel

DescriptionDetermines how instances of the component are assigned to threads for method execution. Values correspond to COM threading models.
AccessReadOnly
TypeLongPossible values:COMAdminThreadingModelApartment (0)COMAdminThreadingModelFree (1)COMAdminThreadingModelMain (2)COMAdminThreadingModelBoth (3)COMAdminThreadingModelNeutral (4)COMAdminThreadingModelNotSpecified (5)
DefaultN/A
Minimum systemWindows 2000

 

Transaction

DescriptionDetermines how a component supports transactions. It is recommended that you use the constants in the enumeration and not the numeric values.
AccessReadWrite
TypeLongPossible values:COMAdminTransactionIgnored (0)COMAdminTransactionNone (1)COMAdminTransactionSupported (2)COMAdminTransactionRequired (3)COMAdminTransactionRequiresNew (4)
DefaultCOMAdminTransactionNone (1)
Minimum systemWindows 2000

 

TxIsolationLevel

DescriptionIndicates the transaction isolation levels. There are five isolation levels: none, read uncommitted, read committed, repeatable read, and serialized. The default isolation level is serialized.
AccessReadWrite
TypeLongPossible values:COMAdminTxIsolationLevelAny (0)COMAdminTxIsolationLevelReadUnCommitted (1)COMAdminTxIsolationLevelReadCommitted (2)COMAdminTxIsolationLevelRepeatableRead (3)COMAdminTxIsolationLevelSerializable (4)
DefaultCOMAdminTxIsolationLevelSerializable (4)
Minimum systemWindows XP

 

VersionBuild

DescriptionVersion build identifier.
AccessReadOnly
TypeString
Default""
Minimum systemWindows 2000

 

VersionMajor

DescriptionVersion identifier.
AccessReadOnly
TypeString
Default""
Minimum systemWindows 2000

 

VersionMinor

DescriptionVersion sub-identifier.
AccessReadOnly
TypeString
Default""
Minimum systemWindows 2000

 

VersionSubBuild

DescriptionVersion sub-build identifier.
AccessReadOnly
TypeString
Default""
Minimum systemWindows 2000

 

See also

COM+ Administration Collections

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.