LocalComputer 컬렉션

  • 아티클

카탈로그에 액세스하는 컴퓨터에 해당하는 단일 개체를 포함합니다. 이 개체는 컴퓨터 수준 설정 정보를 보유합니다. COMAdminCatalog 클래스에서 만든 개체에서 Connect 메서드를 호출하는 경우 LocalComputer 컬렉션의 개체에는 사용자가 액세스하는 카탈로그가 있는 원격 컴퓨터에 대한 정보가 포함됩니다.

이 컬렉션은 COMAdminCatalogCollection 개체의 Add 및 Remove 메서드를 지원하지 않습니다.

멤버

LocalComputer 컬렉션은 IUnknown 인터페이스에서 상속되지만 추가 멤버는 없습니다.

이 컬렉션에서 다음 컬렉션으로 이동할 수 있습니다.

다음 컬렉션에서 이 컬렉션으로 이동할 수 있습니다.

속성

다음 속성은 컬렉션 내의 COMAdminCatalogObject 개체에서 지원됩니다.

ApplicationProxyRSN

입력 값
설명 기본적으로 애플리케이션 프록시에서 사용하는 원격 서버 이름입니다.
Access ReadWrite
Type 문자열
기본값 ""
최소 시스템 Windows 2000

 

CISEnabled

입력 값
설명 COM Internet Services를 사용할 수 있는지 여부를 나타냅니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

DCOMEnabled

입력 값
설명 컴퓨터에서 DCOM을 사용하도록 설정하려면 True로 설정합니다.
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

 

참고

COM에서 CoInitializeSecurity를 호출하면 COMAdminAuthenticationDefault가 COMAdminAuthenticationConnect에 매핑됩니다. 숫자 값이 아닌 열거형의 상수를 사용하는 것이 좋습니다.

 

DefaultImpersonationLevel

입력 값
설명 설정되지 않은 경우 허용하는 가장 수준입니다.
Access ReadWrite
형식 가능한 긴 값:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4)
기본값 COMAdminImpersonationIdentify (2)
최소 시스템 Windows 2000

 

참고

숫자 값이 아닌 열거형의 상수를 사용하는 것이 좋습니다.

 

DefaultToInternetPorts

입력 값
Description 제공된 포트의 기본 형식이 인터넷(True) 또는 인트라넷(False)인지 여부를 결정합니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

Description

입력 값
Description 컴퓨터에 대한 설명입니다.
Access ReadWrite
Type 문자열
기본값 ""
최소 시스템 Windows 2000

 

DSPartitionLookupEnabled

입력 값
Description 파티션 매핑의 사용자가 도메인 저장소에 체크 인되었는지 여부를 나타냅니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows Server 2003

 

InternetPortsListed

입력 값
Description Ports 속성에 나열된 포트를 인터넷(True) 또는 인트라넷(False)에 사용할지 여부를 결정합니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

IsRouter

입력 값
Description 컴퓨터가 CLB(구성 요소 부하 분산) 서비스의 라우터인 경우 True로 설정합니다. 이 속성은 구성 요소 부하 분산 서비스가 현재 컴퓨터에 설치된 경우에만 True로 설정할 수 있습니다. 그렇지 않으면 COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM 오류가 발생합니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

이 속성을 True로 설정하면 CLB 서버가 구성되고 시작 시 시작됩니다. 서버가 아직 없는 경우 ApplicationCluster 컬렉션에 추가됩니다.

LoadBalancingCLSID

입력 값
Description 균형을 맞출 개체의 CLSID입니다.
Access ReadWrite
Type 문자열
기본값 NULL
최소 시스템 Windows XP

 

LocalPartitionLookupEnabled

입력 값
Description 파티션 매핑의 사용자가 로컬 저장소에 체크 인되는지 여부를 나타냅니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows Server 2003

 

속성

입력 값
Description 컴퓨터의 이름. 문자열의 시작과 끝에 있는 추가 공백이 제거됩니다. 이 속성은 이 컬렉션의 개체에서 Key 또는 Name 속성 메서드를 호출할 때 반환됩니다.
Access WriteOnce
Type 문자열
기본값 "내 컴퓨터"
최소 시스템 Windows 2000

 

OperatingSystem

입력 값
Description 로컬 컴퓨터에 설치된 운영 체제입니다.
Access ReadWrite
형식 가능한 긴 값:COMAdminOSNotInitialized (0)COMAdminOSWindows3_1(1)COMAdminOSWindows9x (2)COMAdminOSWindows2000 (3)COMAdAdminOSWindows2000AdvancedServer (4)COMAdminOSWindows2000Unknown (5)COMAdminOSUnknown (6)COMAdminOSWindowsXPPersonal (11)COMAdminOSWindowsXPProfessional (12)COMAdminOSWindowsNETStandardServer (13)COMAdminOSWindowsNETEnterpriseServer (14)COMAdminOSWindowsNETDatacenterServer (15)COMAdminOSWindowsNETWebServer (16)
기본값 COMAdminOSNotInitialized (0)
최소 시스템 Windows 2000

 

PartitionsEnabled

입력 값
Description 로컬 컴퓨터에서 COM+ 파티션을 사용할 수 있는지 여부를 나타냅니다. 이 속성이 False이면 COM+ 파티션을 사용하려고 하면 오류가 발생합니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows Server 2003

 

포트

입력 값
Description InternetPortsListed 속성에 따라 인터넷 또는 인트라넷 사용용 포트를 설명하는 문자열입니다. 예: "500-599: 600-800".
Access ReadWrite
Type 문자열
기본값 ""
최소 시스템 Windows 2000

 

ResourcePoolingEnabled

입력 값
Description 리소스 디스펜서를 사용할 수 있습니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows 2000

 

RPCProxyEnabled

입력 값
Description RPC IIS 프록시를 사용할 수 있는지 여부를 제어합니다. RPC IIS 프록시는 IIS와 함께 IIS에서 RPC 메커니즘에 대한 호출을 전달하는 데 사용되며 CISEnabled를 True로 설정하여 사용하도록 설정된 COM Internet Services의 핵심 부분 중 하나입니다. RPCProxyEnabled에 대한 자세한 내용은 HTTP RPC 보안을 참조하세요.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

SecureReferencesEnabled

입력 값
Description IUnknown::AddRef 및 IUnknown::Release 메서드에 대한 교차 프로세스 호출이 보호되는 DCOM 컴퓨터에서 를 적용합니다.
Access ReadWrite
형식 Bool
기본값 False
최소 시스템 Windows 2000

 

SecurityTrackingEnabled

입력 값
Description 개체에서 보안 추적을 사용하도록 설정하면 True로 설정합니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows 2000

 

SRPActivateAsActivatorChecks

입력 값
Description SRP(소프트웨어 제한 정책)가 활성화자 연결로 활성화를 처리하는 방법을 결정합니다. True로 설정하면 서버 개체에 대해 구성된 SRP 신뢰 수준이 클라이언트 개체의 SRP 신뢰 수준과 비교되고 서버 개체를 실행하는 데 더 높은(더 엄격한) 신뢰 수준이 사용됩니다. False로 설정하면 서버가 구성된 SRP 신뢰 수준에 관계없이 서버 개체가 클라이언트 개체의 SRP 신뢰 수준으로 실행됩니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows XP

 

SRPRunningObjectChecks

입력 값
Description SRP(소프트웨어 제한 정책)가 기존 프로세스에 대한 시도된 연결을 처리하는 방법을 결정합니다. False로 설정하면 실행 중인 개체에 연결하려는 시도가 적절한 SRP 신뢰 수준에 대해 확인되지 않습니다. True로 설정하면 실행 중인 개체의 SRP 신뢰 수준이 클라이언트 개체보다 같거나 높아야 합니다. 예를 들어 무제한 SRP 신뢰 수준이 있는 클라이언트 개체는 허용되지 않는 SRP 신뢰 수준을 사용하여 실행 중인 개체에 연결할 수 없습니다.
Access ReadWrite
형식 Bool
기본값 True
최소 시스템 Windows XP

 

TransactionTimeout

입력 값
Description 트랜잭션 내에서 여러 작업을 수행하는 경우 초 단위로 충분한 값으로 설정해야 합니다. 기본 제한 시간은 60초이고 최대 제한 시간은 3600초(1시간)입니다. 이 속성을 0으로 설정하면 트랜잭션 시간 초과가 비활성화됩니다. 이 속성은 Components 컬렉션의 ComponentTransactionTimeout 속성을 사용하여 개별 구성 요소 에서 재정의할 수 있습니다.
Access ReadWrite
형식 Long(0-3600)
기본값 60
최소 시스템 Windows 2000

 

예제

다음 Microsoft Visual Basic 예제에서는 원격 컴퓨터의 LocalComputer 컬렉션을 사용하여 원격 컴퓨터에 연결하고 SecurityTrackingEnabled 속성을 가져오는 방법을 보여 줍니다. 이 예제를 사용하려면 Visual Basic 프로젝트에 대한 참조로 COM+ 관리 형식 라이브러리를 추가합니다.

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+ 관리 컬렉션