Win32_NetworkConnection クラス - WMI Library

Win32_NetworkConnection クラスの説明

Win32_NetworkConnection クラスは、Win32 環境のアクティブ状態のネットワーク接続を表します。
WMI Providerは、CIMWin32です。
UUIDは、{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}です。

---

プロパティ リスト

AccessMask

Data Type: uint32

Access Type: Read Only

AccessMask プロパティは、リモートで設定された、ユーザーまたはグループが保持しているネットワーク共有上のアクセス権を表すビット配列です。このユーザーまたはグループの代わりにインスタンスが返されます。このプロパティは、Windows NT/Windows 2000 システムでのみサポートされます。

Caption

Data Type: string

Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

Comment

Data Type: string

Access Type: Read Only

Comment プロパティにはネットワークのプロバイダーから提供されているコメントが含まれています。

ConnectionState

Data Type: string

Access Type: Read Only

ConnectionState プロパティは、ネットワーク接続の現在の状態を示します。

ConnectionType

Data Type: string

Access Type: Read Only

ConnectionState プロパティは、ネットワークへの接続で使用される接続の固定の種類を示します。
例: Permanent

Description

Data Type: string

Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

DisplayType

Data Type: string

Access Type: Read Only

DisplayType プロパティは、ネットワーク オブジェクトがユーザー インターフェイスを参照しているネットワークでどのように表示されるかを示します。
例: 汎用

InstallDate

Data Type: datetime

Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

LocalName

Data Type: string

Access Type: Read Only

LocalName プロパティは、接続されたネットワーク デバイスのローカル名を示します。
例: c:\public

Name

Data Type: string

Access Type: Read Only

Name プロパティは、現在のネットワーク接続の名前を示します。RemoteName プロパティの値と LocalName プロパティの値の組み合わせです。
例: \\NTRELEASE (c:\public)

Persistent

Data Type: boolean

Access Type: Read Only

Persistent プロパティにより、次の接続時にオペレーティング システムによってこの接続が自動的に再接続されるかどうかが決定されます。
値: TRUE または FALSE です。値 TRUE はネットワーク接続が自動的に行われることを示します。

ProviderName

Data Type: string

Access Type: Read Only

ProviderName プロパティには、リソースがあるプロバイダーの名前が含まれています。このプロパティはプロバイダー名が不明な場合は NULL になります。

RemoteName

Data Type: string

Access Type: Read Only

RemoteName プロパティには、ネットワーク リソースのリモート ネットワーク リソース名が含まれています。現在の接続または固定接続用に、RemoteName には LocalName プロパティの値の名前に関連付けされているネットワーク名が含まれています。RemoteName の名前は、ネットワーク プロバイダーの名前付け規則に従っていなければなりません。
例: \\NTRELEASE

RemotePath

Data Type: string

Access Type: Read Only

RemotePath プロパティには、ネットワーク リソースへの完全なパスが含まれています。
例: \\infosrv1\public

ResourceType

Data Type: string

Access Type: Read Only

ResourceType プロパティは、列挙または接続するリソース タイプを示します。

Status

Data Type: string

Access Type: Read Only

Status プロパティはオブジェクトの現在の状態を示す文字列です。操作可能な状態および操作不可能な状態が定義されます。操作可能な状態は、"OK"、"低下" および "障害が発生する可能性あり" です。"障害が発生する可能性あり" は、要素は適切に機能するけれども近いうちに障害が発生する可能性があることを示します。例: SMART 対応ハード ディスク。操作不可能な状態も指定できます。これは、"エラー"、"開始中"、"停止動作中" および "サービス" です。最後の "サービス" には、ディスクがミラーされている間、ユーザーのアクセス許可の一覧を再度読み込む間、または他の管理用作業が行われている間などが該当します。この作業がすべてオンラインで行われるとは限りませんが、[管理要素] は "OK" でも他の状態でもありません。

UserName

Data Type: string

Access Type: Read Only

UserName プロパティには、ネットワーク接続の確立に使用されるユーザー名または既定のユーザー名が含まれています。
例: SYSTEM

---

メソッド リスト

Win32_NetworkConnectionクラスにはメソッドはありません。

---

WQL サンプル

SELECT * FROM Win32_NetworkConnection

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM Win32_NetworkConnection")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM Win32_NetworkConnection"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM Win32_NetworkConnection"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているWin32_NetworkConnectionクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---