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 类具有以下类型的成员：

属性

属性

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)

分配写入所有者。

同步 (1048576)

同步访问并允许进程等待对象进入信号状态。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

注释

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|lpComment“)

网络提供商提供的注释。

ConnectionState

数据类型： 字符串
访问类型：只读
限定符：MaxLen (20) ，MappingStrings (“Win32API|网络管理结构 || USE_INFO_1ui1_status“)

网络连接的当前状态。

Connected (“Connected”)

错误 (“错误”)

已暂停 (“暂停”)

断开连接 (“断开连接”)

连接 (“连接”)

重新连接 (“重新连接”)

ConnectionType

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|dwScope“)

用于连接到网络的连接的持久性类型。

当前连接 (“当前连接”)

持久连接 (“持久连接”)

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

DisplayType

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|dwDisplayType“)

网络对象应显示在网络浏览用户界面中。

域 (“域”)

泛型 (“Generic”)

服务器 (“Server”)

共享 (“共享”)

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

LocalName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|lpLocalName“)

连接的网络设备的本地名称。

示例：“c：\public”

名称

数据类型： 字符串
访问类型：只读
限定符：键、重写 (“Name”) 、 MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE“)

当前网络连接的名称。它是 RemoteName 和 LocalName 中值的组合。

示例：“\\NTRELEASE (c：\public) ”

Persistent

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络函数 |WNetEnumResource“)

操作系统将在下次登录时自动重新连接。

ProviderName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|lpProvider“)

拥有资源的提供程序的名称。如果提供程序名称未知，则此属性可以为 NULL 。

RemoteName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|lpRemoteName“)

网络资源的远程网络资源名称。对于当前连接或持久连接， RemoteName 包含与 LocalName 属性中值的名称关联的网络名称。 RemoteName 中的名称必须遵循网络提供商的命名约定。

示例：“\\NTRELEASE”

RemotePath

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|lpRemoteName“)

网络资源的完整路径。

示例：“\\infosrv1\public”

ResourceType

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络结构 |NETRESOURCE|dwType“)

要枚举或连接到的资源类型。

Disk (“Disk”)

打印 (“Print”)

任何 (“Any”)

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“降级”和“预失败”。 “Pred Fail”表示某个元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

UserName

数据类型： 字符串
访问类型：只读
限定符： 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 类

语法

成员

属性

备注

示例

要求

另请参阅

反馈

其他资源