通过

(netlistmgr.h) 的 INetwork 接口

  • 项目

INetwork 接口表示本地计算机上的网络。 它还可以表示具有类似网络签名的网络连接的集合。

继承

INetwork 接口继承自 IUnknown 接口。 INetwork 还包含以下类型的成员：

方法

INetwork 接口具有这些方法。

 
INetwork：：get_IsConnected

get_IsConnected 属性指定网络是否具有任何网络连接。
INetwork：：get_IsConnectedToInternet

get_IsConnectedToInternet 属性指定网络是否具有 Internet 连接。
INetwork：：GetCategory

GetCategory 方法返回网络的类别。
INetwork：：GetConnectivity

GetConnectivity 方法返回网络的连接状态。
INetwork：：GetDescription

GetDescription 方法返回网络的说明字符串。
INetwork：：GetDomainType

GetDomainType 方法返回网络的域类型。
INetwork：：GetName

GetName 方法返回网络的名称。
INetwork：：GetNetworkConnections

GetNetworkConnections 方法返回网络的所有网络连接的枚举。 一个网络可以从不同的接口或来自同一接口的不同链接来建立多个连接。
INetwork：：GetNetworkId

GetNetworkId 方法返回网络的唯一标识符。
INetwork：：GetTimeCreatedAndConnected

GetTimeCreatedAndConnected 方法返回创建和连接网络时的本地日期和时间。
INetwork：：SetCategory

SetCategory 方法设置网络的类别。 所做的更改将立即生效。 此 API 的调用方必须是管理员组的成员。
INetwork：：SetDescription

SetDescription 方法设置或替换网络的说明。
INetwork：：SetName

SetName 方法设置或重命名网络。

注解

实现 INetwork 的 COM 对象还实现其他属性的属性包。 若要访问此属性包，可以使用 INetwork 接口和适用于 IPropertyBag 的QueryInterface。 此 COM 对象上的属性包包含以下属性：

参数 类型 说明
NA_DomainAuthenticationFailed VT_BOOL 指定域网络无法对域控制器进行身份验证。
NA_NetworkClass 存储为VT_UINT 的NLM_NETWORK_CLASS值 指定网络的类。 可能的值包括：
  • NLM_NETWORK_IDENTIFYING (0x01)

    这是特殊的“标识”网络。 无法更改此网络类的属性。

  • NLM_NETWORK_IDENTIFIED (0x02)

    这是一个已识别的网络。

  • NLM_NETWORK_UNIDENTIFIED (0x03)

    这是特殊的“未识别”网络。 此网络的类别可以更改，但在网络断开连接时不会保留。
NA_InternetConnectivityV4

或

NA_InternetConnectivityV6

 存储为VT_UINT 的NLM_INTERNET_CONNECTIVITY值 提供有关 IPv4 或 IPv6 网络连接的详细信息。 可能的值包括：
  • NLM_INTERNET_CONNECTIVITY_WEBHIJACK (0x1)

    检测到的网络是热点。 例如，当连接到咖啡 Wi-Fi 热点网络，并且本地 HTTP 流量被重定向到强制门户时，将设置此标志。

  • NLM_INTERNET_CONNECTIVITY_PROXIED (0x2)

    检测到的网络具有代理配置。 例如，在使用代理进行 HTTP 访问连接到公司网络时，将设置此标志。

  • NLM_INTERNET_CONNECTIVITY_CORPORATE (0x4)

    已为计算机配置了直接访问，并且检测到对已为其配置了直接访问的企业域网络进行访问。
NA_NameSetByPolicy VT_BOOL 网络的名称已由组策略设置。
NA_IconSetByPolicy VT_BOOL 网络图标已由组策略设置。
NA_DescriptionSetByPolicy VT_BOOL 网络说明已由组策略设置。
NA_CategorySetByPolicy VT_BOOL 网络类别已由组策略设置。
NA_NameReadOnly VT_BOOL 网络的名称是只读的。
NA_IconReadOnly VT_BOOL 网络的图标是只读的。
NA_DescriptionReadOnly VT_BOOL 网络的说明是只读的。
NA_CategoryReadOnly VT_BOOL 网络的类别为只读。
NA_AllowMerge VT_BOOL 该网络可以与其他网络合并。
 

IPropertyBag 接口接受 LPCOLESTR 作为 IPropertyBag：：Read 和 IPropertyBag：：Write 方法的一部分。 为方便起见，这些属性的字符串值在 netlistmgr.h 中使用相同的名称定义。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netlistmgr.h