Коллекция LocalComputer
Содержит один объект, соответствующий компьютеру, к каталогу которого вы обращаетесь. Этот объект содержит сведения о параметрах уровня компьютера. При вызове метода Connect для объекта, созданного из класса COMAdminCatalog , объект в коллекции LocalComputer содержит сведения об удаленном компьютере, каталог которого вы обращаетесь.
Эта коллекция не поддерживает методы Add и Remove объекта COMAdminCatalogCollection .
Элементы
Коллекция LocalComputer наследуется от интерфейса IUnknown , но не имеет дополнительных членов.
Связанные коллекции
Из этой коллекции можно перейти к любой из следующих коллекций:
Вы можете перейти к этой коллекции из следующих коллекций:
Свойства
Следующие свойства поддерживаются объектом COMAdminCatalogObject в коллекции:
- ApplicationProxyRSN
- CISEnabled
- DCOMEnabled
- DefaultAuthenticationLevel
- DefaultImpersonationLevel
- DefaultToInternetPorts
- Описание
- DSPartitionLookupEnabled
- InternetPortsListed
- IsRouter
- LoadBalancingCLSID
- LocalPartitionLookupEnabled
- имя;
- OperatingSystem
- PartitionsEnabled
- Порты
- ResourcePoolingEnabled
- RPCProxyEnabled
- SecureReferencesEnabled
- SecurityTrackingEnabled
- SRPActivateAsActivatorChecks
- SRPRunningObjectChecks
- TransactionTimeout
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
См. также раздел