Edit

LegacyComponents collection

  • Article

Contains an object for each unconfigured component in the Applications collection. Unconfigured components cannot make use of COM+ services. 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 LegacyComponents collection inherits from the IUnknown interface but does not have additional members.

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:

AccessPermissions

Entry Value
Description Specifies the user accounts that are allowed or denied access to the component.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

ActivateAtStorage

Entry Value
Description Specifies whether to run the server on the data storage machine.
Access ReadWrite
Type String Possible values:"N""Y"
Default "N"
Minimum system Windows XP

 

AppID

Entry Value
Description The application ID.
Access ReadOnly
Type String
Default N/A
Minimum system Windows XP

 

AppName

Entry Value
Description The name of the application.
Access ReadOnly
Type String
Default N/A
Minimum system Windows XP

 

AuthenticationLevel

Entry Value
Description 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 within the LocalComputer collection is used.
Access ReadWrite
Type Long Possible values:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Default COMAdminAuthenticationDefault (0)
Minimum system Windows XP

 

Note

It is recommended that you use the constants in the enumeration and not the numeric values.

 

Bitness

Entry Value
Description Represents the binary bitness type of the component. On systems that use 64-bit Windows, this property distinguishes between 64-bit components and 32-bit components.
Access ReadOnly
Type Long Possible values:COMAdmin32BitComponent (0x1)COMAdmin64BitComponent (0x2)
Default N/A
Minimum system Windows XP

 

ClassName

Entry Value
Description The name of the class.
Access ReadOnly
Type String
Default N/A
Minimum system Windows XP

 

CLSID

Entry Value
Description 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
Minimum system Windows XP

 

DllSurrogate

Entry Value
Description Specifies the full path to a surragate server application.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

InprocHandler32

Entry Value
Description Specifies the full path to a 32-bit in-process custom handler DLL.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

InprocServer32

Entry Value
Description Specifies the full path to a 32-bit in-process server DLL.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

IsEnabled

Entry Value
Description 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
Minimum system Windows XP

 

LaunchPermissions

Entry Value
Description Specifies user accounts that are allowed or denied permission to start this component.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

LocalServer32

Entry Value
Description Specifies the full path to a 32-bit local server application. To help protect system security, use quoted strings in the path to indicate where the executable filename ends and the arguments begin. For example, "\"C:\Program Files\Company Files\Application.exe\" param1 param2".
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

LocalService

Entry Value
Description Specifies the full path to the service application.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

Password

Entry Value
Description Sets the password used by the server process to log on under the specified RunAs identity. Password should be set at the same time as the RunAs 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 component cannot be launched until they are reset by an administrator.
Access WriteOnly
Type String
Default NULL
Minimum system Windows XP

 

ProgID

Entry Value
Description A name 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
Minimum system Windows XP

 

RemoteServer

Entry Value
Description Specifies the remote server computer.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

RunAs

Entry Value
Description Specifies the user under whose identity the component will run. Password should be set at the same time as the RunAs 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 component cannot be launched until they are reset by an administrator.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

ServiceParameter

Entry Value
Description Specifies the parameters passed to the application when invoked as a service application.
Access ReadWrite
Type String
Default N/A
Minimum system Windows XP

 

SRPTrustLevel

Entry Value
Description Indicates the software restriction policy (SRP) trust level of the component. The SRP trust level refers to the level of trust that you are willing to give to a component. 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.
Access ReadWrite
Type Long Possible values:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000)
Default SAFER_LEVELID_FULLYTRUSTED
Minimum system Windows XP

 

A component 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.

ThreadingModel

Entry Value
Description Determines how instances of the component are assigned to threads for method execution. Values correspond to COM threading models.
Access ReadOnly
Type Long Possible values:COMAdminThreadingModelApartment (0)COMAdminThreadingModelFree (1)COMAdminThreadingModelMain (2)COMAdminThreadingModelBoth (3)COMAdminThreadingModelNeutral (4)
Default N/A
Minimum system Windows XP

 

See also

COM+ Administration Collections