LocalComputer collection
Applies to: desktop apps only
Contains a single object that corresponds to the computer whose catalog you are accessing. This object holds computer level settings information. If you call the Connect method on an object created from the COMAdminCatalog class, the object in the LocalComputer collection contains information about the remote computer whose catalog you are accessing.
This collection does not support the Add and Remove methods of the COMAdminCatalogCollection object.
Members
The LocalComputer 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:
- ApplicationProxyRSN
- CISEnabled
- DCOMEnabled
- DefaultAuthenticationLevel
- DefaultImpersonationLevel
- DefaultToInternetPorts
- Description
- DSPartitionLookupEnabled
- InternetPortsListed
- IsRouter
- LoadBalancingCLSID
- LocalPartitionLookupEnabled
- Name
- OperatingSystem
- PartitionsEnabled
- Ports
- ResourcePoolingEnabled
- RPCProxyEnabled
- SecureReferencesEnabled
- SecurityTrackingEnabled
- SRPActivateAsActivatorChecks
- SRPRunningObjectChecks
- TransactionTimeout
ApplicationProxyRSN
| Description | Remote server name used by application proxies by default. |
| Access | ReadWrite |
| Type | String |
| Default | "" |
| Minimum system | Windows 2000 |
CISEnabled
| Description | Indicates whether COM Internet Services is enabled. |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
DCOMEnabled
| Description | Set to True to enable DCOM on the computer. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows 2000 |
DefaultAuthenticationLevel
| Description | Authentication level used by applications that have Authentication set to Default. Values correspond to the Remote Procedure Call (RPC) authentication settings. |
| Access | ReadWrite |
| Type | LongPossible values:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6) |
| Default | COMAdminAuthenticationConnect (2) |
| Minimum system | Windows 2000 |
Note COMAdminAuthenticationDefault is mapped to COMAdminAuthenticationConnect when COM calls CoInitializeSecurity. It is recommended that you use the constants in the enumeration and not the numeric values.
DefaultImpersonationLevel
| Description | Impersonation level to allow if one is not set. |
| Access | ReadWrite |
| Type | LongPossible values:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4) |
| Default | COMAdminImpersonationIdentify (2) |
| Minimum system | Windows 2000 |
Note It is recommended that you use the constants in the enumeration, and not the numeric values.
DefaultToInternetPorts
| Description | Determines whether the default type of port provided should be Internet (True) or intranet (False). |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
Description
| Description | A description of the computer. |
| Access | ReadWrite |
| Type | String |
| Default | "" |
| Minimum system | Windows 2000 |
DSPartitionLookupEnabled
| Description | Indicates whether the user of the partition mappings is checked into the domain store. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows Server 2003 |
InternetPortsListed
| Description | Determines whether the ports listed in the Ports property are to be used for Internet (True) or for intranet (False). |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
IsRouter
| Description | Set to True if the computer is a router for the component load balancing (CLB) service. This property can be set to True only if the component load balancing service is currently installed on the computer; otherwise, it errors with COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM. |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
If this property is set to True, the CLB server is configured and starts at startup. The server is added to the ApplicationCluster collection if it is not already present.
LoadBalancingCLSID
| Description | The CLSID of the object to balance. |
| Access | ReadWrite |
| Type | String |
| Default | NULL |
| Minimum system | Windows XP |
LocalPartitionLookupEnabled
| Description | Indicates whether the user of the partition mappings is checked into the local store. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows Server 2003 |
Name
| Description | The name of the computer. Extra spaces at the beginning and end of the string are stripped out. This property is returned when the Key or Name property method is called on an object of this collection. |
| Access | WriteOnce |
| Type | String |
| Default | "My Computer" |
| Minimum system | Windows 2000 |
OperatingSystem
| Description | The operating system installed on the local computer. |
| Access | ReadWrite |
| Type | LongPossible values:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (6)COMAdminOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16) |
| Default | COMAdminOSNotInitialized (0) |
| Minimum system | Windows 2000 |
PartitionsEnabled
| Description | Indicates whether COM+ partitions can be used on the local computer. If this property is False, any attempt to use COM+ partitions results in an error. |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows Server 2003 |
Ports
| Description | A string describing ports that are for either Internet or intranet use, depending on the InternetPortsListed property; for example, "500-599: 600-800". |
| Access | ReadWrite |
| Type | String |
| Default | "" |
| Minimum system | Windows 2000 |
ResourcePoolingEnabled
| Description | Enables use of resource dispensers. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows 2000 |
RPCProxyEnabled
| Description | Controls whether the RPC IIS proxy is enabled. The RPC IIS proxy is used in conjunction with IIS to forward calls to the RPC mechanism from IIS and is one of the core pieces of COM Internet Services, which is enabled by setting CISEnabled to True. For more information on RPCProxyEnabled, see HTTP RPC Security. |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
SecureReferencesEnabled
| Description | Enforces in DCOM computers that cross-process calls to IUnknown::AddRef and IUnknown::Release methods are secured. |
| Access | ReadWrite |
| Type | Bool |
| Default | False |
| Minimum system | Windows 2000 |
SecurityTrackingEnabled
| Description | Set to True if security tracking is enabled on objects. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows 2000 |
SRPActivateAsActivatorChecks
| Description | Determines how the software restriction policy (SRP) handles activate-as-activator connections. If set to True, the SRP trust level that is configured for the server object is compared with the SRP trust level of the client object and the higher (more stringent) trust level is used to run the server object. If set to False, the server object runs with the SRP trust level of the client object, regardless of the SRP trust level with which the server is configured. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows XP |
SRPRunningObjectChecks
| Description | Determines how the software restriction policy (SRP) handles attempted connections to existing processes. If set to False, attempts to connect to running objects are not checked for appropriate SRP trust levels. If set to True, the running object must have an equal or higher (more stringent) SRP trust level than the client object. For example, a client object with an Unrestricted SRP trust level cannot connect to a running object with a Disallowed SRP trust level. |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| Minimum system | Windows XP |
TransactionTimeout
| Description | Should be set to a sufficient value in seconds if you are doing numerous operations within a transaction. The default time-out period is 60 seconds, and the maximum time-out period is 3600 seconds (1 hour). Setting this property to 0 disables transaction time-outs. This property can be overridden by individual components by using the ComponentTransactionTimeout property of the Components collection. |
| Access | ReadWrite |
| Type | Long (0-3600) |
| Default | 60 |
| Minimum system | Windows 2000 |
Example
The following Microsoft Visual Basic example demonstrates how to connect to a remote computer and get its SecurityTrackingEnabled property by using the LocalComputer collection of the remote computer. To use this example, add the COM+ Admin Type Library as a reference to your Visual Basic project.
Function RemoteComputerConnect(strComputer As String _ ) As Boolean ' Return False if any errors occur. RemoteComputerConnect = False ' Initialize the function. On Error GoTo My_Error_Handler ' Initialize error handling. Dim boolSTE As Boolean Dim objCatalog As COMAdminCatalog Dim objRemoteRootColl As COMAdminCatalogCollection Dim objRemoteComputerColl As COMAdminCatalogCollection Dim objRemoteComputerItem As COMAdminCatalogObject Set objCatalog = CreateObject("COMAdmin.COMAdminCatalog") Set objRemoteRootColl = objCatalog.Connect(strComputer) Set objRemoteComputerColl = objRemoteRootColl.GetCollection( _ "LocalComputer", objRemoteRootColl.Name) objRemoteComputerColl.Populate Set objRemoteComputerItem = objRemoteComputerColl.Item(0) boolSTE = objRemoteComputerItem.Value("SecurityTrackingEnabled") If boolSTE Then MsgBox "Security Tracking is enabled on " & strComputer Else MsgBox "Security Tracking is NOT enabled on " & strComputer End If Set objRemoteComputerItem = Nothing Set objRemoteComputerColl = Nothing Set objRemoteRootColl = Nothing Set objCatalog = Nothing RemoteComputerConnect = True ' Successful end to procedure Exit Function My_Error_Handler: ' Replace with specific error handling. MsgBox "Error # " & Err.Number & " (Hex: " & Hex(Err.Number) _ & ")" & vbNewLine & Err.Description Set objRemoteComputerItem = Nothing Set objRemoteComputerColl = Nothing Set objRemoteRootColl = Nothing Set objCatalog = Nothing End Function
To use the function, provide a string value for the name of the remote computer. The following Visual Basic code shows how to connect to the computer named "RemoteComputerName".
Sub Main() If Not RemoteComputerConnect("RemoteComputerName") Then MsgBox "RemoteComputerConnect failed." End If End Sub
See also
Send comments about this topic to Microsoft
Build date: 2/3/2012
