Поделиться через


Коллекция LocalComputer

Содержит один объект, соответствующий компьютеру, к каталогу которого вы обращаетесь. Этот объект содержит сведения о параметрах уровня компьютера. При вызове метода Connect для объекта, созданного из класса COMAdminCatalog , объект в коллекции LocalComputer содержит сведения об удаленном компьютере, каталог которого вы обращаетесь.

Эта коллекция не поддерживает методы Add и Remove объекта COMAdminCatalogCollection .

Элементы

Коллекция LocalComputer наследуется от интерфейса IUnknown , но не имеет дополнительных членов.

Из этой коллекции можно перейти к любой из следующих коллекций:

Вы можете перейти к этой коллекции из следующих коллекций:

Свойства

Следующие свойства поддерживаются объектом COMAdminCatalogObject в коллекции:

ApplicationProxyRSN

Ввод Значение
Описание Имя удаленного сервера, используемое прокси-серверами приложений по умолчанию.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

CISEnabled

Ввод Значение
Описание Указывает, включены ли COM-службы Интернета.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

DCOMEnabled

Ввод Значение
Описание Установите значение True, чтобы включить DCOM на компьютере.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows 2000

 

DefaultAuthenticationLevel

Ввод Значение
Описание Уровень проверки подлинности, используемый приложениями, для которых задана проверка подлинности по умолчанию. Значения соответствуют параметрам проверки подлинности удаленного вызова процедур (RPC).
Access ReadWrite
Тип Длинные возможные значения:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6)
По умолчанию COMAdminAuthenticationConnect (2)
Минимальная система Windows 2000

 

Примечание

COMAdminAuthenticationDefault сопоставляется с COMAdminAuthenticationConnect, когда COM вызывает CoInitializeSecurity. Рекомендуется использовать константы в перечислении, а не числовые значения.

 

DefaultImpersonationLevel

Ввод Значение
Описание Уровень олицетворения, допустимый, если он не задан.
Access ReadWrite
Тип Long Possible values:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
По умолчанию COMAdminImpersonationIdentify (2)
Минимальная система Windows 2000

 

Примечание

Рекомендуется использовать константы в перечислении, а не числовые значения.

 

DefaultToInternetPorts

Ввод Значение
Описание Определяет, должен ли быть предоставленный тип порта по умолчанию — Интернет (True) или интрасети (False).
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

Описание

Ввод Значение
Описание Описание компьютера.
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

DSPartitionLookupEnabled

Ввод Значение
Описание Указывает, будет ли пользователь сопоставлений секций возвращен в хранилище домена.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows Server 2003

 

InternetPortsListed

Ввод Значение
Описание Определяет, будут ли порты, перечисленные в свойстве Порты, использоваться для Интернета (True) или для интрасети (False).
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

IsRouter

Ввод Значение
Описание Установите значение True, если компьютер является маршрутизатором для службы балансировки нагрузки компонентов (CLB). Этому свойству можно присвоить значение True только в том случае, если служба балансировки нагрузки компонентов в настоящее время установлена на компьютере; В противном случае возникает ошибка с COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

Если для этого свойства задано значение True, сервер CLB настраивается и запускается при запуске. Сервер добавляется в коллекцию ApplicationCluster, если он еще не существует.

LoadBalancingCLSID

Ввод Значение
Описание ИДЕНТИФИКАТОР CLSID объекта для балансировки.
Access ReadWrite
Тип Строка
По умолчанию NULL
Минимальная система Windows XP

 

LocalPartitionLookupEnabled

Ввод Значение
Описание Указывает, будет ли пользователь сопоставлений секций возвращен в локальное хранилище.
Access ReadWrite
Тип Bool
По умолчанию True
Минимальная система Windows Server 2003

 

Имя

Ввод Значение
Описание Имя компьютера. Дополнительные пробелы в начале и конце строки удаляются. Это свойство возвращается при вызове метода свойства Key или Name для объекта этой коллекции.
Access WriteOnce
Тип Строка
По умолчанию "Мой компьютер"
Минимальная система Windows 2000

 

OperatingSystem

Ввод Значение
Описание Операционная система, установленная на локальном компьютере.
Access ReadWrite
Тип Возможные значения: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)
По умолчанию COMAdminOSNotInitialized (0)
Минимальная система Windows 2000

 

PartitionsEnabled

Ввод Значение
Описание Указывает, можно ли использовать секции COM+ на локальном компьютере. Если это свойство имеет значение False, любая попытка использовать секции COM+ приводит к ошибке.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows Server 2003

 

порты;

Ввод Значение
Описание Строка, описывающая порты, используемые в Интернете или интрасети в зависимости от свойства InternetPortsListed; например, "500-599: 600-800".
Access ReadWrite
Тип Строка
По умолчанию ""
Минимальная система Windows 2000

 

ResourcePoolingEnabled

Ввод Значение
Описание Позволяет использовать диспенсеры ресурсов.
Access ReadWrite
Тип Bool
По умолчанию True
Минимальная система Windows 2000

 

RPCProxyEnabled

Ввод Значение
Описание Определяет, включен ли прокси-сервер IIS RPC. Прокси-сервер IIS RPC используется совместно со службами IIS для переадресации вызовов механизма RPC из СЛУЖБ IIS и является одним из основных компонентов служб COM Internet Services, для которых для параметра CISEnabled задано значение True. Дополнительные сведения о RPCProxyEnabled см. в разделе Http RPC Security.
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

SecureReferencesEnabled

Ввод Значение
Описание На компьютерах DCOM обеспечивается защита межпроцессных вызовов методов IUnknown::AddRef и IUnknown::Release .
Access ReadWrite
Тип Bool
Значение по умолчанию Неверно
Минимальная система Windows 2000

 

SecurityTrackingEnabled

Ввод Значение
Описание Установите значение True, если для объектов включено отслеживание безопасности.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows 2000

 

SRPActivateAsActivatorChecks

Ввод Значение
Описание Определяет, как политика ограниченного использования программного обеспечения (SRP) обрабатывает подключения "активация как активатор". Если задано значение True, уровень доверия SRP, настроенный для объекта сервера, сравнивается с уровнем доверия SRP клиентского объекта, а для запуска объекта сервера используется более высокий (более строгий) уровень доверия. Если задано значение False, объект сервера выполняется с уровнем доверия SRP клиентского объекта независимо от уровня доверия SRP, с которым настроен сервер.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows XP

 

SRPRunningObjectChecks

Ввод Значение
Описание Определяет, как политика ограниченного использования программного обеспечения (SRP) обрабатывает попытки подключения к существующим процессам. Если задано значение False, попытки подключения к запущенным объектам не проверяются на наличие соответствующих уровней доверия SRP. Если задано значение True, выполняющийся объект должен иметь уровень доверия SRP, равный или более высокий (более строгий), чем клиентский объект. Например, клиентский объект с уровнем доверия "Неограниченный SRP" не может подключиться к работающему объекту с уровнем доверия Запрещенная SRP.
Access ReadWrite
Тип Bool
Значение по умолчанию True
Минимальная система Windows XP

 

TransactionTimeout

Ввод Значение
Описание При выполнении большого количества операций в транзакции должно быть задано достаточное значение в секундах. Время ожидания по умолчанию составляет 60 секунд, а максимальное время ожидания — 3600 секунд (1 час). Если задать для этого свойства значение 0, время ожидания транзакций отключается. Это свойство может быть переопределено отдельными компонентами с помощью свойства ComponentTransactionTimeout коллекции Components .
Access ReadWrite
Тип Long (0–3600)
По умолчанию 60
Минимальная система Windows 2000

 

Пример

В следующем примере Microsoft Visual Basic показано, как подключиться к удаленному компьютеру и получить его свойство SecurityTrackingEnabled с помощью коллекции LocalComputer удаленного компьютера. Чтобы использовать этот пример, добавьте библиотеку типов COM+ Администратор в качестве ссылки на проект 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


Чтобы использовать функцию , укажите строковое значение для имени удаленного компьютера. В следующем коде Visual Basic показано, как подключиться к компьютеру с именем RemoteComputerName.

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

См. также раздел

Коллекции администрирования COM+