Win32_NetworkConnection クラス

[アーティクル]
06/12/2023

Win32_NetworkConnectionWMI クラスは、Windows ベースの環境でのアクティブなネットワーク接続を表します。

次の構文はマネージドオブジェクトフォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。プロパティとメソッドは、MOF の順序ではなく、アルファベット順です。

構文

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CD-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkConnection : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  string   Comment;
  string   ConnectionState;
  string   ConnectionType;
  string   DisplayType;
  string   LocalName;
  string   Name;
  boolean  Persistent;
  string   ProviderName;
  string   RemoteName;
  string   RemotePath;
  string   ResourceType;
  string   UserName;
};

メンバー

Win32_NetworkConnection クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Win32_NetworkConnection クラスには、これらのプロパティがあります。

AccessMask

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

インスタンスの代わりに返されるユーザーまたはグループによって保持されている特定のファイルまたはディレクトリへのアクセス権の一覧。 FAT ボリュームでは、代わりに FULL_ACCESS 値が返され、オブジェクトにセキュリティが設定されていないことを示します。

FILE_READ_DATA (ファイル) またはFILE_LIST_DIRECTORY (ディレクトリ) ( 1)

ファイルからデータを読み取る権限を付与します。ディレクトリの場合、この値はディレクトリの内容を一覧表示する権限を付与します。

FILE_WRITE_DATA (ファイル) またはFILE_ADD_FILE (ディレクトリ) ( 2)

ファイルにデータを書き込む権限を付与します。ディレクトリの場合、この値はディレクトリにファイルを作成する権限を付与します。

FILE_APPEND_DATA (ファイル) またはFILE_ADD_SUBDIRECTORY (4)

ファイルにデータを追加する権限を付与します。ディレクトリの場合、この値はサブディレクトリを作成する権限を付与します。

FILE_READ_EA (8)

拡張属性を読み取る権限を付与します。

FILE_WRITE_EA (16)

拡張属性を書き込む権限を付与します。

FILE_EXECUTE (ファイル) またはFILE_TRAVERSE (ディレクトリ) ( 32)

ファイルを実行する権限を付与します。ディレクトリの場合、ディレクトリを走査できます。

FILE_DELETE_CHILD (ディレクトリ) (64)

ファイルが読み取り専用であっても、ディレクトリとそのディレクトリに含まれるすべてのファイル (その子) を削除する権限を付与します。

FILE_READ_ATTRIBUTES (128)

ファイル属性を読み取る権限を付与します。

FILE_WRITE_ATTRIBUTES (256)

ファイル属性を変更する権限を付与します。

DELETE (65536)

削除アクセスを許可します。

READ_CONTROL (131072)

セキュリティ記述子と所有者への読み取りアクセスを許可します。

WRITE_DAC (262144)

随意アクセス制御リスト (DACL) への書き込みアクセスを許可します。

WRITE_OWNER (524288)

書き込み所有者を割り当てます。

SYNCHRONIZE (1048576)

アクセスを同期し、オブジェクトがシグナル状態になるまでプロセスが待機できるようにします。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキストの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

解説

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpComment")

ネットワークプロバイダーによって提供されるコメント。

ConnectionState

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (20)、MappingStrings ("Win32API|ネットワーク管理構造|| USE_INFO_1ui1_status")

ネットワーク接続の現在の状態。

接続済み ("接続済み")

エラー ("Error")

一時停止 ("一時停止")

切断済み ("Disconnected")

接続 ("接続")

再接続 ("再接続")

ConnectionType

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwScope")

ネットワークへの接続に使用される接続の永続化の種類。

現在の接続 ("現在の接続")

永続的な接続 ("永続的な接続")

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトのテキストの説明。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

DisplayType

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwDisplayType")

ネットワークオブジェクトは、ネットワーク参照ユーザーインターフェイスに表示する必要があります。

ドメイン ("Domain")

Generic ("Generic")

サーバー ("Server")

共有 ("共有")

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされた日時を示します。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

Localname

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpLocalName")

接続されているネットワークデバイスのローカル名。

例: "c:\public"

Name

データ型: string
アクセスの種類: 読み取り専用
修飾子: key、 Override ("Name")、 MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE")

現在のネットワーク接続の名前。 RemoteName と LocalName の値の組み合わせです。

例: "\\NTRELEASE (c:\public)"

永続的

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク関数|WNetEnumResource")

接続は、次のログオン時にオペレーティングシステムによって自動的に再接続されます。

ProviderName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpProvider")

リソースを所有するプロバイダーの名前。プロバイダー名が不明な場合、このプロパティは NULL にすることができます。

RemoteName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpRemoteName")

ネットワークリソースのリモートネットワークリソース名。現在または永続的な接続の場合、 RemoteName には LocalName プロパティの値の名前に関連付けられたネットワーク名が含まれます。 RemoteName の名前は、ネットワークプロバイダーの名前付け規則に従う必要があります。

例: "\\NTRELEASE"

[RemotePath]

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|lpRemoteName")

ネットワークリソースへの完全なパス。

例: "\\infosrv1\public"

ResourceType

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク構造|NETRESOURCE|dwType")

列挙または接続するリソースの種類。

ディスク ("Disk")

印刷 ("Print")

Any ("Any")

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。操作状態と非運用状態を定義できます。運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハードディスクドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始中 ("Starting")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

UserName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|Windows ネットワーク関数|WNetGetUser")

ネットワーク接続を確立するために使用されるユーザー名または既定のユーザー名。

例: "SYSTEM"

注釈

Win32_NetworkConnection クラスは、CIM_LogicalElementから派生します。

例

次の VBScript コードサンプルでは、ローカルネットワーク接続に関する情報を取得します。

On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\Root\CIMv2")
Set colItems = objWMIService.ExecQuery("Select * from Win32_NetworkConnection",,48)
For Each objItem in colItems
    Wscript.Echo "AccessMask: " & objItem.AccessMask
    Wscript.Echo "Caption: " & objItem.Caption
    Wscript.Echo "Comment: " & objItem.Comment
    Wscript.Echo "ConnectionState: " & objItem.ConnectionState
    Wscript.Echo "ConnectionType: " & objItem.ConnectionType
    Wscript.Echo "Description: " & objItem.Description
    Wscript.Echo "DisplayType: " & objItem.DisplayType
    Wscript.Echo "InstallDate: " & objItem.InstallDate
    Wscript.Echo "LocalName: " & objItem.LocalName
    Wscript.Echo "Name: " & objItem.Name
    Wscript.Echo "Persistent: " & objItem.Persistent
    Wscript.Echo "ProviderName: " & objItem.ProviderName
    Wscript.Echo "RemoteName: " & objItem.RemoteName
    Wscript.Echo "RemotePath: " & objItem.RemotePath
    Wscript.Echo "ResourceType: " & objItem.ResourceType
    Wscript.Echo "Status: " & objItem.Status
    Wscript.Echo "UserName: " & objItem.UserName
Next

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

CIM_LogicalElement
オペレーティングシステムクラス

次の方法で共有

Win32_NetworkConnection クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース