Colección LocalComputer
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.
Colecciones relacionadas
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
- CISEnabled
- DCOMEnabled
- DefaultAuthenticationLevel
- DefaultImpersonationLevel
- DefaultToInternetPorts
- Descripción
- DSPartitionLookupEnabled
- InternetPortsListed
- IsRouter
- LoadBalancingCLSID
- LocalPartitionLookupEnabled
- Nombre
- OperatingSystem
- PartitionsEnabled
- Puertos
- ResourcePoolingEnabled
- RPCProxyEnabled
- SecureReferencesEnabled
- SecurityTrackingEnabled
- SRPActivateAsActivatorChecks
- SRPRunningObjectChecks
- TransactionTimeout
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de