Coleção LocalComputer

  • Artigo

Contém um único objeto que corresponde ao computador cujo catálogo você está acessando. Esse objeto contém informações de configurações de nível de computador. Se você chamar o método Connect em um objeto criado a partir da classe COMAdminCatalog , o objeto na coleção LocalComputer conterá informações sobre o computador remoto cujo catálogo você está acessando.

Essa coleção não dá suporte aos métodos Add e Remove do objeto COMAdminCatalogCollection .

Membros

A coleção LocalComputer herda da interface IUnknown , mas não tem membros adicionais.

Você pode navegar desta coleção para qualquer uma das seguintes coleções:

Você pode navegar para essa coleção a partir das seguintes coleções:

Propriedades

As propriedades a seguir são compatíveis com o objeto COMAdminCatalogObject dentro da coleção:

ApplicationProxyRSN

Entrada Valor
Descrição Nome do servidor remoto usado por proxies de aplicativo por padrão.
Access ReadWrite
Type String
Padrão ""
Sistema mínimo Windows 2000

 

CISEnabled

Entrada Valor
Descrição Indica se os Serviços de Internet COM estão habilitados.
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

DCOMEnabled

Entrada Valor
Descrição Defina como True para habilitar o DCOM no computador.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows 2000

 

DefaultAuthenticationLevel

Entrada Valor
Descrição Nível de autenticação usado por aplicativos que têm a Autenticação definida como Padrão. Os valores correspondem às configurações de autenticação de RPC (Chamada de Procedimento Remoto).
Access ReadWrite
Type Valores long possible:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
Padrão COMAdminAuthenticationConnect (2)
Sistema mínimo Windows 2000

 

Observação

COMAdminAuthenticationDefault é mapeado para COMAdminAuthenticationConnect quando COM chama CoInitializeSecurity. É recomendável que você use as constantes na enumeração e não os valores numéricos.

 

DefaultImpersonationLevel

Entrada Valor
Descrição Nível de representação a ser permitido se um não estiver definido.
Access ReadWrite
Type Valores Long Possible:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
Padrão COMAdminImpersonationIdentify (2)
Sistema mínimo Windows 2000

 

Observação

É recomendável que você use as constantes na enumeração e não os valores numéricos.

 

DefaultToInternetPorts

Entrada Valor
Descrição Determina se o tipo padrão de porta fornecido deve ser Internet (True) ou intranet (False).
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

Descrição

Entrada Valor
Descrição Uma descrição do computador.
Access ReadWrite
Type String
Padrão ""
Sistema mínimo Windows 2000

 

DSPartitionLookupEnabled

Entrada Valor
Descrição Indica se o usuário dos mapeamentos de partição está verificado no repositório de domínio.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows Server 2003

 

InternetPortsListed

Entrada Valor
Descrição Determina se as portas listadas na propriedade Portas devem ser usadas para Internet (True) ou para intranet (False).
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

IsRouter

Entrada Valor
Descrição Defina como True se o computador for um roteador para o serviço CLB (balanceamento de carga de componente). Essa propriedade só poderá ser definida como True se o serviço de balanceamento de carga do componente estiver instalado no computador; caso contrário, ele erros com COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM.
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

Se essa propriedade estiver definida como True, o servidor CLB será configurado e começará na inicialização. O servidor será adicionado à coleção ApplicationCluster se ainda não estiver presente.

LoadBalancingCLSID

Entrada Valor
Descrição O CLSID do objeto a ser balanceado.
Access ReadWrite
Type String
Padrão NULO
Sistema mínimo Windows XP

 

LocalPartitionLookupEnabled

Entrada Valor
Descrição Indica se o usuário dos mapeamentos de partição está verificado no repositório local.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows Server 2003

 

Nome

Entrada Valor
Descrição O nome do computador. Espaços extras no início e no final da cadeia de caracteres são removidos. Essa propriedade é retornada quando o método de propriedade Key ou Name é chamado em um objeto dessa coleção.
Access WriteOnce
Type String
Padrão "Meu Computador"
Sistema mínimo Windows 2000

 

OperatingSystem

Entrada Valor
Descrição O sistema operacional instalado no computador local.
Access ReadWrite
Type Valores long possible:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (6)COMAdminOSOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16)
Padrão COMAdminOSNotInitialized (0)
Sistema mínimo Windows 2000

 

PartitionsEnabled

Entrada Valor
Descrição Indica se as partições COM+ podem ser usadas no computador local. Se essa propriedade for False, qualquer tentativa de usar partições COM+ resultará em um erro.
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows Server 2003

 

Portas

Entrada Valor
Descrição Uma cadeia de caracteres que descreve portas que são para uso de Internet ou intranet, dependendo da propriedade InternetPortsListed; por exemplo, "500-599: 600-800".
Access ReadWrite
Type String
Padrão ""
Sistema mínimo Windows 2000

 

ResourcePoolingEnabled

Entrada Valor
Descrição Habilita o uso de distribuidores de recursos.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows 2000

 

RPCProxyEnabled

Entrada Valor
Descrição Controla se o proxy RPC IIS está habilitado. O proxy RPC IIS é usado em conjunto com o IIS para encaminhar chamadas para o mecanismo RPC do IIS e é uma das principais partes dos Serviços de Internet COM, que é habilitada definindo CISEnabled como True. Para obter mais informações sobre RPCProxyEnabled, consulte Segurança HTTP RPC.
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

SecureReferencesEnabled

Entrada Valor
Descrição Impõe em computadores DCOM que as chamadas entre processos para os métodos IUnknown::AddRef e IUnknown::Release são protegidas.
Access ReadWrite
Type Bool
Padrão Falso
Sistema mínimo Windows 2000

 

SecurityTrackingEnabled

Entrada Valor
Descrição Defina como True se o rastreamento de segurança estiver habilitado em objetos .
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows 2000

 

SRPActivateAsActivatorChecks

Entrada Valor
Descrição Determina como a política de restrição de software (SRP) lida com conexões ativadas como ativadoras. Se definido como True, o nível de confiança SRP configurado para o objeto de servidor será comparado com o nível de confiança SRP do objeto cliente e o nível de confiança mais alto (mais rigoroso) será usado para executar o objeto de servidor. Se definido como False, o objeto de servidor será executado com o nível de confiança SRP do objeto cliente, independentemente do nível de confiança SRP com o qual o servidor está configurado.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows XP

 

SRPRunningObjectChecks

Entrada Valor
Descrição Determina como a política de restrição de software (SRP) lida com tentativas de conexões com processos existentes. Se definido como False, as tentativas de se conectar a objetos em execução não serão verificadas quanto aos níveis de confiança SRP apropriados. Se definido como True, o objeto em execução deverá ter um nível de confiança SRP igual ou superior (mais rigoroso) do que o objeto cliente. Por exemplo, um objeto cliente com um nível de confiança SRP irrestrito não pode se conectar a um objeto em execução com um nível de confiança SRP não permitido.
Access ReadWrite
Type Bool
Padrão True
Sistema mínimo Windows XP

 

TransactionTimeout

Entrada Valor
Descrição Deve ser definido como um valor suficiente em segundos se você estiver fazendo várias operações dentro de uma transação. O período de tempo limite padrão é de 60 segundos e o período máximo de tempo limite é de 3600 segundos (1 hora). Definir essa propriedade como 0 desabilita o tempo limite da transação. Essa propriedade pode ser substituída por componentes individuais usando a propriedade ComponentTransactionTimeout da coleção Components .
Access ReadWrite
Type Long (0-3600)
Padrão 60
Sistema mínimo Windows 2000

 

Exemplo

O exemplo do Microsoft Visual Basic a seguir demonstra como se conectar a um computador remoto e obter sua propriedade SecurityTrackingEnabled usando a coleção LocalComputer do computador remoto. Para usar este exemplo, adicione o COM+ Administração Biblioteca de Tipos como uma referência ao seu projeto do 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 a função , forneça um valor de cadeia de caracteres para o nome do computador remoto. O código do Visual Basic a seguir mostra como se conectar ao computador chamado "RemoteComputerName".

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

Confira também

Coleções de administração COM+