Compartir a través de

Colección LocalComputer

  • Artículo

Contiene un único objeto que corresponde al equipo cuyo catálogo está accediendo. Este objeto contiene información de configuración de nivel de equipo. Si llama al método Connect en un objeto creado a partir de la clase COMAdminCatalog , el objeto de la colección LocalComputer contiene información sobre el equipo remoto cuyo catálogo está accediendo.

Esta colección no admite los métodos Add y Remove del objeto COMAdminCatalogCollection .

Miembros

La colección LocalComputer hereda de la interfaz IUnknown , pero no tiene miembros adicionales.

Puede navegar desde esta colección a cualquiera de las colecciones siguientes:

Puede ir a esta colección desde las siguientes colecciones:

Propiedades

El objeto COMAdminCatalogObject admite las siguientes propiedades dentro de la colección:

ApplicationProxyRSN

Entrada Value
Descripción Nombre del servidor remoto que usan los servidores proxy de aplicación de forma predeterminada.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

CISEnabled

Entrada Value
Descripción Indica si los servicios de Internet COM están habilitados.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

DCOMEnabled

Entrada Value
Descripción Establezca en True para habilitar DCOM en el equipo.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows 2000

 

DefaultAuthenticationLevel

Entrada Value
Descripción Nivel de autenticación que usan las aplicaciones que tienen la autenticación establecida en Predeterminado. Los valores corresponden a la configuración de autenticación de llamada a procedimiento remoto (RPC).
Access ReadWrite
Tipo Long Valores posibles:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Valor predeterminado COMAdminAuthenticationConnect (2)
Sistema mínimo Windows 2000

 

Nota:

COMAdminAuthenticationDefault se asigna a COMAdminAuthenticationConnect cuando COM llama a CoInitializeSecurity. Se recomienda usar las constantes de la enumeración y no los valores numéricos.

 

DefaultImpersonationLevel

Entrada Value
Descripción Nivel de suplantación que se va a permitir si no se establece uno.
Access ReadWrite
Tipo Valores posibles largos:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Valor predeterminado COMAdminImpersonationIdentify (2)
Sistema mínimo Windows 2000

 

Nota

Se recomienda usar las constantes de la enumeración y no los valores numéricos.

 

DefaultToInternetPorts

Entrada Value
Descripción Determina si el tipo predeterminado de puerto proporcionado debe ser Internet (True) o intranet (False).
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

Descripción

Entrada Value
Descripción Descripción del equipo.
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

DSPartitionLookupEnabled

Entrada Value
Descripción Indica si el usuario de las asignaciones de particiones está protegido en el almacén de dominios.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows Server 2003

 

InternetPortsListed

Entrada Value
Descripción Determina si los puertos enumerados en la propiedad Ports se usarán para Internet (True) o para intranet (False).
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

IsRouter

Entrada Value
Descripción Se establece en True si el equipo es un enrutador para el servicio de equilibrio de carga de componentes (CLB). Esta propiedad solo se puede establecer en True si el servicio de equilibrio de carga de componentes está instalado actualmente en el equipo; de lo contrario, se produce un error con COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

Si esta propiedad se establece en True, el servidor CLB se configura y se inicia en el inicio. El servidor se agrega a la colección ApplicationCluster si aún no está presente.

LoadBalancingCLSID

Entrada Value
Descripción CLSID del objeto que se va a equilibrar.
Access ReadWrite
Tipo String
Predeterminado NULL
Sistema mínimo Windows XP

 

LocalPartitionLookupEnabled

Entrada Value
Descripción Indica si el usuario de las asignaciones de particiones está protegido en el almacén local.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows Server 2003

 

Nombre

Entrada Value
Descripción Nombre del equipo. Se quitan espacios adicionales al principio y al final de la cadena. Esta propiedad se devuelve cuando se llama al método de propiedad Key o Name en un objeto de esta colección.
Access WriteOnce
Tipo String
Predeterminado "Mi computadora"
Sistema mínimo Windows 2000

 

OperatingSystem

Entrada Value
Descripción Sistema operativo instalado en el equipo local.
Access ReadWrite
Tipo Long Valores posibles:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (4)COMAdminOSUnknown (4)COMAdminOSUnknown (4)COMAdminOSWindows2000Unknown (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (4)COMAdminOSUnknown (4)COMAdminOSUnknown (4)COMAdminOSWindows6)COMAdminOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16)
Valor predeterminado COMAdminOSNotInitialized (0)
Sistema mínimo Windows 2000

 

PartitionsEnabled

Entrada Value
Descripción Indica si se pueden usar particiones COM+ en el equipo local. Si esta propiedad es False, cualquier intento de usar particiones COM+ produce un error.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows Server 2003

 

Puertos

Entrada Value
Descripción Cadena que describe los puertos que son para uso de Internet o intranet, dependiendo de la propiedad InternetPortsListed; por ejemplo, "500-599: 600-800".
Access ReadWrite
Tipo String
Predeterminado ""
Sistema mínimo Windows 2000

 

ResourcePoolingEnabled

Entrada Value
Descripción Habilita el uso de dispensadores de recursos.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows 2000

 

RPCProxyEnabled

Entrada Value
Descripción Controla si el proxy DE IIS rpc está habilitado. El proxy RPC IIS se usa junto con IIS para reenviar llamadas al mecanismo RPC desde IIS y es una de las partes principales de los servicios de Internet COM, que se habilita estableciendo CISEnabled en True. Para obtener más información sobre RPCProxyEnabled, consulte Seguridad de RPC HTTP.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

SecureReferencesEnabled

Entrada Value
Descripción Aplica en equipos DCOM que las llamadas entre procesos a los métodos IUnknown::AddRef e IUnknown::Release están protegidos.
Access ReadWrite
Tipo Bool
Valor predeterminado False
Sistema mínimo Windows 2000

 

SecurityTrackingEnabled

Entrada Value
Descripción Se establece en True si el seguimiento de seguridad está habilitado en objetos .
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows 2000

 

SRPActivateAsActivatorChecks

Entrada Value
Descripción Determina cómo controla la directiva de restricción de software (SRP) las conexiones activate-as-activator. Si se establece en True, el nivel de confianza de SRP configurado para el objeto de servidor se compara con el nivel de confianza SRP del objeto de cliente y se usa el nivel de confianza más alto (más estricto) para ejecutar el objeto de servidor. Si se establece en False, el objeto de servidor se ejecuta con el nivel de confianza SRP del objeto de cliente, independientemente del nivel de confianza de SRP con el que esté configurado el servidor.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows XP

 

SRPRunningObjectChecks

Entrada Value
Descripción Determina cómo controla la directiva de restricción de software (SRP) las conexiones intentadas a los procesos existentes. Si se establece en False, los intentos de conectarse a objetos en ejecución no se comprueban si hay niveles de confianza de SRP adecuados. Si se establece en True, el objeto en ejecución debe tener un nivel de confianza de SRP igual o superior (más estricto) que el objeto de cliente. Por ejemplo, un objeto de cliente con un nivel de confianza de SRP sin restricciones no se puede conectar a un objeto en ejecución con un nivel de confianza de SRP no permitido.
Access ReadWrite
Tipo Bool
Valor predeterminado True
Sistema mínimo Windows XP

 

TransactionTimeout

Entrada Value
Descripción Debe establecerse en un valor suficiente en segundos si está realizando numerosas operaciones dentro de una transacción. El período de tiempo de espera predeterminado es de 60 segundos y el período de tiempo de espera máximo es de 3600 segundos (1 hora). Al establecer esta propiedad en 0, se deshabilitan los tiempos de espera de la transacción. Esta propiedad se puede invalidar por componentes individuales mediante la propiedad ComponentTransactionTimeout de la colección Components .
Access ReadWrite
Tipo Long (0-3600)
Valor predeterminado 60
Sistema mínimo Windows 2000

 

Ejemplo

En el siguiente ejemplo de Microsoft Visual Basic se muestra cómo conectarse a un equipo remoto y obtener su propiedad SecurityTrackingEnabled mediante la colección LocalComputer del equipo remoto. Para usar este ejemplo, agregue com+ Administración biblioteca de tipos como referencia al proyecto de Visual Basic.

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

Para usar la función , proporcione un valor de cadena para el nombre del equipo remoto. El siguiente código de Visual Basic muestra cómo conectarse al equipo denominado "RemoteComputerName".

Sub Main()
    If Not RemoteComputerConnect("RemoteComputerName") Then
        MsgBox "RemoteComputerConnect failed."
    End If
End Sub

Consulte también

Colecciones de administración de COM+