网络列表管理器

网络列表管理器技术概述。

若要开发网络列表管理器，需要以下标头：

• netlistmgr.h
• ondemandconnroutehelper.h

有关此技术的编程指南，请参阅：

• 网络列表管理器

枚举

NLM_CONNECTION_COST NLM_CONNECTION_COST枚举指定 Windows 8 成本 API 中支持的一组成本级别和成本标志。
NLM_CONNECTION_PROPERTY_CHANGE NLM_CONNECTION PROPERTY_CHANGE枚举是一组标志，用于定义对网络连接属性所做的更改。
NLM_CONNECTIVITY NLM_Connectivity枚举是一组标志，每当与连接相关的参数发生更改时，这些标志都提供通知。
NLM_DOMAIN_AUTHENTICATION_KIND 定义指定域身份验证方法的常量。
NLM_DOMAIN_TYPE NLM_DOMAIN_TYPE枚举是一组指定网络的域类型的标志。
NLM_ENUM_NETWORK NLM_ENUM_NETWORK枚举包含一组标志，这些标志指定枚举的网络类型。
NLM_INTERNET_CONNECTIVITY NLM_INTERNET_CONNECTIVITY枚举定义了一组标志，这些标志为 IPv4 或 IPv6 网络连接提供附加数据。
NLM_NETWORK_CATEGORY NLM_NETWORK_CATEGORY枚举是一组指定网络的类别类型的标志。
NLM_NETWORK_CLASS NLM_NETWORK_CLASS枚举定义一组标志，用于指定是否已标识网络。
NLM_NETWORK_PROPERTY_CHANGE NLM_NETWORK_PROPERTY_CHANGE枚举是一组标志，用于定义对网络属性所做的更改。

函数

ClearSimulatedProfileInfo 清除以前由 SetSimulatedProfileInfo 应用于 Internet 连接配置文件的连接配置文件值。 下一个 Internet 连接查询（通过 GetInternetConnectionProfile）将使用系统信息。
克隆 Clone 方法创建一个枚举器，该枚举器包含与当前使用的枚举器相同的枚举状态。 (IEnumNetworkConnections.Clone)
克隆 Clone 方法创建一个枚举器，该枚举器包含与当前使用的枚举器相同的枚举状态。 (IEnumNetworks.Clone)
ConnectionCostChanged ConnectionCostChanged 方法通知应用程序连接的网络成本更改。
ConnectionDataPlanStatusChanged ConnectionDataPlanStatusChanged 方法在连接上通知应用程序数据计划状态更改。
ConnectivityChanged 发生网络连接相关更改时，将调用 NetworkConnectivityChanged 方法。 (INetworkListManagerEvents.ConnectivityChanged)
CostChanged 调用 CostChanged 方法以指示计算机范围的 Internet 连接或路由到连接上特定目标的第一跃点的成本更改。
DataPlanStatusChanged 调用 DataPlanStatusChanged 方法以指示与用于计算机范围的 Internet 连接的连接或路由到连接上特定目标的第一跃点关联的数据计划的状态发生更改。
FreeInterfaceContextTable 此函数释放使用 GetInterfaceContextTableForHostName 函数检索的接口上下文表。
get__NewEnum get_NewEnum 属性返回可用于循环访问 IEnumNetworkConnections 集合的自动化枚举器对象。
get__NewEnum get_NewEnum 属性返回可用于循环访问 IEnumNetworks 集合的自动化枚举器对象。
get_IsConnected get_IsConnected 属性指定网络是否具有任何网络连接。
get_IsConnected get_IsConnected 属性指定关联的网络连接是否具有网络连接。
get_IsConnected get_IsConnected 属性指定本地计算机是否具有网络连接。
get_IsConnectedToInternet get_IsConnectedToInternet 属性指定网络是否具有 Internet 连接。
get_IsConnectedToInternet get_IsConnectedToInternet 属性指定关联的网络连接是否具有 Internet 连接。
get_IsConnectedToInternet get_IsConnectedToInternet 属性指定本地计算机是否具有 Internet 连接。
GetAdapterId GetAdapterID 方法返回此连接使用的网络适配器的 ID。
GetCategory GetCategory 方法返回网络的类别。
GetConnectionId GetConnectionID 方法返回与此网络连接关联的连接 ID。
GetConnectivity GetConnectivity 方法返回网络的连接状态。
GetConnectivity GetConnectivity 方法返回网络连接的连接状态。
GetConnectivity GetConnectivity 方法返回计算机的总体连接状态。
GetCost GetCost 方法检索与连接关联的网络成本。
GetCost GetCost 方法检索计算机范围的 Internet 连接或路由到连接上特定目标的第一跃点的当前成本。
GetDataPlanStatus GetDataPlanStatus 方法检索与连接关联的数据计划的状态。
GetDataPlanStatus GetDataPlanStatus 检索计算机范围的 Internet 连接或路由到连接上特定目标的第一跃点的数据计划状态。
GetDescription GetDescription 方法返回网络的说明字符串。
GetDomainType GetDomainType 方法返回网络的域类型。
GetDomainType GetDomainType 方法返回网络连接的域类型。
GetInterfaceContextTableForHostName 此函数检索给定主机名和连接配置文件筛选器的接口上下文表。
GetName GetName 方法返回网络的名称。
GetNetwork GetNetwork 方法返回与连接关联的网络。
GetNetwork GetNetwork 方法根据提供的网络 ID 检索网络。
GetNetworkConnection GetNetworkConnection 方法根据提供的网络连接 ID 检索网络。
GetNetworkConnections GetNetworkConnections 方法返回网络的所有网络连接的枚举。 一个网络可以从不同的接口或来自同一接口的不同链接来建立多个连接。
GetNetworkConnections GetNetworkConnections 方法枚举已建立的网络连接的完整列表。
GetNetworkId GetNetworkId 方法返回网络的唯一标识符。
GetNetworks GetNetworks 方法检索本地计算机上可用的网络列表。
GetTimeCreatedAndConnected GetTimeCreatedAndConnected 方法返回创建和连接网络时的本地日期和时间。
IsDomainAuthenticatedBy 查询此网络的指定域身份验证方法是否成功。
IsDomainAuthenticatedBy 查询此网络连接的指定域身份验证方法是否成功。
NetworkAdded 添加新网络时，将调用 NetworkAdded 方法。 提供了新网络的 GUID。
NetworkConnectionConnectivityChanged 当网络连接级别发生连接更改事件时，NetworkConnectionConnectivityChanged 方法通知客户端。
NetworkConnectionPropertyChanged 当发生与特定网络连接相关的属性更改事件时，NetworkConnectionPropertyChanged 方法会通知客户端。
NetworkConnectivityChanged 发生与网络连接相关的更改时，将调用 NetworkConnectivityChanged 方法。 (INetworkEvents.NetworkConnectivityChanged)
NetworkDeleted 删除网络时，将调用 NetworkDeleted 方法。
NetworkPropertyChanged 检测到网络属性更改时，将调用 NetworkPropertyChanged 方法。
下一页 Next 方法获取枚举序列中下一个指定数量的元素。 (IEnumNetworkConnections.Next)
下一页 Next 方法获取枚举序列中下一个指定数量的元素。 (IEnumNetworks.Next)
OnDemandGetRoutingHint OnDemandGetRoutingHint 函数在路由请求缓存中查找目标，如果找到匹配项，则返回相应的接口 ID。
OnDemandRegisterNotification OnDemandRegisterNotification 函数允许应用程序注册，以在修改路由请求缓存时收到通知。
OnDemandUnRegisterNotification OnDemandUnregisterNotification 函数允许应用程序取消注册通知并清理资源。
重置 Reset 方法将枚举序列重置为开头。 (IEnumNetworkConnections.Reset)
重置 Reset 方法将枚举序列重置为开头。 (IEnumNetworks.Reset)
SetCategory SetCategory 方法设置网络的类别。 所做的更改将立即生效。 此 API 的调用方必须是管理员组的成员。
SetDescription SetDescription 方法设置或替换网络的说明。
SetDestinationAddresses SetDestinationAddresses 方法注册指定的目标 IPv4/IPv6 地址，以接收成本或数据计划状态更改通知。
SetName SetName 方法设置或重命名网络。
SetSimulatedProfileInfo SetSimulatedProfileInfo 方法将一组特定的连接配置文件值应用于 Internet 连接配置文件，以支持模拟特定的按流量计费的 Internet 连接条件。
Skip Skip 方法跳过枚举序列中下一个指定数量的元素。 (IEnumNetworkConnections.Skip)
Skip Skip 方法跳过枚举序列中下一个指定数量的元素。 (IEnumNetworks.Skip)

接口

IEnumNetworkConnections IEnumNetworkConnections 接口为网络连接提供标准枚举器。 它枚举网络中的活动、断开连接或所有网络连接。 可以从 INetwork 接口获取此接口。
IEnumNetworks IEnumNetworks 接口是网络的标准枚举器。 它枚举本地计算机上可用的所有网络。 可以从 INetworkListManager 接口获取此接口。
INetwork INetwork 接口表示本地计算机上的网络。 它还可以表示具有类似网络签名的网络连接的集合。
INetwork2 INetwork2 接口表示本地计算机上的网络。 它还可以表示具有类似网络签名的网络连接的集合。
INetworkConnection INetworkConnection 接口表示单个网络连接。
INetworkConnection2 INetworkConnection2 接口表示单个网络连接。
INetworkConnectionCost 查询与连接关联的当前网络成本和数据计划状态。
INetworkConnectionCostEvents 此接口用于通知应用程序连接的成本和数据计划状态更改事件。
INetworkConnectionEvents INetworkConnectionEvents 接口是客户端为获取网络连接相关事件而实现的消息接收器接口。 对较低级别事件 (（如身份验证更改) ）感兴趣的应用程序必须实现此接口。
INetworkCostManager 使用此接口可以查询与用于计算机范围的 Internet 连接的连接或路由到连接上特定目标的第一跃点相关联的计算机范围的成本和数据计划状态信息。
INetworkCostManagerEvents 此接口用于通知应用程序计算机范围的成本和数据计划相关事件。
INetworkEvents INetworkEvents 是客户端为获取网络相关事件而实现的通知接收器接口。 这些 API 都是在引发相应事件时自动调用的回调函数。
INetworkListManager INetworkListManager 接口提供了一组用于执行网络列表管理功能的方法。
INetworkListManagerEvents INetworkListManagerEvents 是客户端实现的消息接收器接口，用于获取与计算机状态相关的整体事件。 对更高级别事件（例如 Internet 连接）感兴趣的应用程序实现此接口。

结构

NET_INTERFACE_CONTEXT 属于NET_INTERFACE_CONTEXT_TABLE结构的接口上下文。
NET_INTERFACE_CONTEXT_TABLE NET_INTERFACE_CONTEXT结构的表。
NLM_DATAPLAN_STATUS NLM_DATAPLAN_STATUS结构存储运营商提供的当前数据计划状态信息。
NLM_SIMULATED_PROFILE_INFO 用于指定 SetSimulatedProfileInfo 用于替代 RDP 子会话中的当前 Internet 连接配置文件值的值，以支持模拟特定的按流量计费的 Internet 连接条件。
NLM_SOCKADDR NLM_SOCKADDR结构包含 IPv4/IPv6 目标地址。
NLM_USAGE_DATA NLM_USAGE_DATA结构存储指示计划的数据使用情况的信息。