LocalComputer 集合

包含對應至您要存取其目錄之電腦的單一物件。 此物件會保存電腦層級設定資訊。 如果您在從 COMAdminCatalog類別建立的物件上呼叫Connect方法，LocalComputer集合中的 物件會包含您所存取目錄之遠端電腦的相關資訊。

這個集合不支援COMAdminCatalogCollection物件的Add和Remove方法。

成員

LocalComputer集合繼承自IUnknown介面，但沒有其他成員。

相關集合

您可以從此集合巡覽至下列任何集合：

• ErrorInfo
• PropertyInfo
• RelatedCollectionInfo

您可以從下列集合流覽至此集合：

• 根

屬性

集合內的 COMAdminCatalogObject物件支援下列屬性：

• ApplicationProxyRSN
• CISEnabled
• DCOMEnabled
• DefaultAuthenticationLevel
• DefaultImpersonationLevel
• DefaultToInternetPorts
• 說明
• DSPartitionLookupEnabled
• InternetPortsListed
• IsRouter
• LoadBalancingCLSID
• LocalPartitionLookupEnabled
• 名稱
• OperatingSystem
• PartitionsEnabled
• 連接埠
• ResourcePoolingEnabled
• RPCProxyEnabled
• SecureReferencesEnabled
• SecurityTrackingEnabled
• SRPActivateAsActivatorChecks
• SRPRunningObjectChecks
• TransactionTimeout

ApplicationProxyRSN

進入	值
Description	應用程式 Proxy 預設使用的遠端伺服器名稱。
Access	讀寫
類型	String
預設值	""
最低系統	Windows 2000

 

CISEnabled

進入	值
Description	指出是否啟用 COM 網際網路服務。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

DCOMEnabled

進入	值
Description	設定為 True 以在電腦上啟用 DCOM。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows 2000

 

DefaultAuthenticationLevel

進入	值
Description	已將 [驗證] 設定為 [預設] 的應用程式所使用的驗證層級。 值會對應至遠端程序呼叫 (RPC) 驗證設定。
Access	讀寫
類型	Long Possible values：COMAdminAuthenticationDefault (0) COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2) COMAdminAuthenticationCall (3) COMAdminAuthenticationPacket (4) COMAdminAuthenticationIntegrity (5) COMAdminAuthenticationPrivacy (6)
預設	COMAdminAuthenticationConnect (2)
最低系統	Windows 2000

 

注意

COMAdminAuthenticationDefault 會在 COM 呼叫 CoInitializeSecurity時對應至 COMAdminAuthenticationConnect。 建議您在列舉中使用常數，而不是數值。

 

DefaultImpersonationLevel

進入	值
Description	如果未設定模擬層級，則允許。
Access	讀寫
類型	Long Possible values：COMAdminImpersonationAnonymous (1) COMAdminImpersonationIdentify (2) COMAdminImpersonationImpersonate (3) COMAdminImpersonationDelegate (4)
預設	COMAdminImpersonationIdentify (2)
最低系統	Windows 2000

 

注意

建議您在列舉中使用常數，而不是數值。

 

DefaultToInternetPorts

進入	值
Description	判斷提供的預設埠類型應該是網際網路 (True) 或內部網路 (False) 。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

Description

進入	值
Description	電腦的描述。
Access	讀寫
類型	String
預設值	""
最低系統	Windows 2000

 

DSPartitionLookupEnabled

進入	值
Description	指出資料分割對應的使用者是否已簽入網域存放區。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows Server 2003

 

InternetPortsListed

進入	值
Description	判斷 Ports 屬性中列出的埠是否要用於網際網路 (True) 或內部網路 (False) 。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

IsRouter

進入	值
Description	如果電腦是元件負載平衡的路由器， (CLB) 服務，請將 設定為 True。 只有當元件負載平衡服務目前安裝在電腦上時，此屬性才能設定為 True;否則，它會發生COMADMIN_E_REQUIRES_DIFFERENT_PLATFORM錯誤。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

如果此屬性設定為 True，就會設定 CLB 伺服器並在啟動時啟動。 如果伺服器尚未存在，伺服器就會新增至 ApplicationCluster 集合。

LoadBalancingCLSID

進入	值
Description	要平衡之物件的 CLSID。
Access	讀寫
類型	String
預設值	NULL
最低系統	Windows XP

 

LocalPartitionLookupEnabled

進入	值
Description	指出資料分割對應的使用者是否已簽入本機存放區。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows Server 2003

 

名稱

進入	值
Description	電腦的名稱。 字串開頭和結尾的額外空格會去除。呼叫這個集合物件上的 Key 或 Name 屬性方法時，會傳回這個屬性。
Access	WriteOnce
類型	String
預設值	「我的電腦」
最低系統	Windows 2000

 

OperatingSystem

進入	值
Description	安裝在本機電腦上的作業系統。
Access	讀寫
類型	Long Possible values：COMAdminOSNotInitialized (0) COMAdminOSWindows3_1 (1) COMAdminOSWindows9x (2) COMAdminOSWindows2000 (3) COMAdminOSWindows2000AdvancedServer (4) COMAdminOSWindows2000Unknown (5) COMAdminOSUnk (6) COMAdminOSWindowsXPPersonal (11) COMAdminOSWindowsXPProfessional (12) COMAdminOSWindowsNETStandardServer (13) COMAdminOSWindowsNETEnterpriseServer (14) COMAdminOSWindowsNETDatacenterServer (15) COMAdminOSWindowsNETWebServer (16)
預設	COMAdminOSNotInitialized (0)
最低系統	Windows 2000

 

PartitionsEnabled

進入	值
Description	指出是否可以在本機電腦上使用 COM+ 磁碟分割。 如果此屬性為 False，則任何使用 COM+ 資料分割的嘗試都會導致錯誤。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows Server 2003

 

連接埠

進入	值
Description	字串，描述網際網路或內部網路使用的埠，視 InternetPortsListed 屬性而定;例如，「500-599： 600-800」。
Access	讀寫
類型	String
預設值	""
最低系統	Windows 2000

 

ResourcePoolingEnabled

進入	值
Description	可讓您使用資源配置器。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows 2000

 

RPCProxyEnabled

進入	值
Description	控制是否啟用 RPC IIS Proxy。 RPC IIS Proxy 會與 IIS 搭配使用，以從 IIS 轉送 RPC 機制的呼叫，而且是 COM 網際網路服務的核心片段之一，藉由將 CISEnabled 設定為 True 來啟用。 如需 RPCProxyEnabled 的詳細資訊，請參閱 HTTP RPC 安全性。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

SecureReferencesEnabled

進入	值
Description	在對 IUnknown：：AddRef 和 IUnknown：：Release 方法進行跨進程呼叫的 DCOM 電腦中強制執行。
Access	讀寫
類型	Bool
預設	否
最低系統	Windows 2000

 

SecurityTrackingEnabled

進入	值
Description	如果物件上已啟用安全性追蹤，則設定為 True。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows 2000

 

SRPActivateAsActivatorChecks

進入	值
Description	決定軟體限制原則 (SRP) 如何處理啟動即啟動器連線。 如果設定為 True，則針對伺服器物件設定的 SRP 信任層級會與用戶端物件的 SRP 信任層級進行比較，而使用較高 (更嚴格的) 信任層級來執行伺服器物件。 如果設定為 False，則不論伺服器設定的 SRP 信任層級為何，伺服器物件都會以用戶端物件的 SRP 信任層級執行。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows XP

 

SRPRunningObjectChecks

進入	值
Description	決定軟體限制原則 (SRP) 如何處理嘗試連線到現有的進程。 如果設定為 False，則不會檢查嘗試連線到執行中的物件是否有適當的 SRP 信任層級。 如果設定為 True，則執行中的物件必須具有比用戶端物件更嚴格的) SRP 信任層級 (更高。 例如，具有不受限制 SRP 信任層級的用戶端物件無法連線到具有不允許 SRP 信任等級的執行中物件。
Access	讀寫
類型	Bool
預設	是
最低系統	Windows XP

 

TransactionTimeout

進入	值
Description	如果您要在交易內執行許多作業，則應該以秒為單位設定為足夠的值。 預設逾時期間為 60 秒，而逾時期間上限為 3600 秒， (1 小時) 。 將此屬性設定為 0 會停用交易逾時。 您可以使用 Components 集合的 ComponentTransactionTimeout 屬性，由個別元件覆寫這個屬性。
Access	讀寫
類型	Long (0-3600)
預設	60
最低系統	Windows 2000

 

範例

下列 Microsoft Visual Basic 範例示範如何連線到遠端電腦，並使用遠端電腦的 LocalComputer 集合來取得其 SecurityTrackingEnabled 屬性。 若要使用此範例，請將 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+ 系統管理集合