WLAN_HOSTED_NETWORK_REASON枚举 (wlanapi.h)

项目
08/28/2023

WLAN_HOSTED_NETWORK_REASON枚举类型指定无线托管网络函数调用结果的可能值。

语法

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

常量


`wlan_hosted_network_reason_success` 值： 0 操作成功。
`wlan_hosted_network_reason_unspecified` 未知错误。
`wlan_hosted_network_reason_bad_parameters` 参数错误。例如，如果应用程序未能从正确的句柄引用客户端上下文， (wlanOpenHandle 函数) 返回的句柄，则返回此原因代码。
`wlan_hosted_network_reason_service_shutting_down` 服务正在关闭。
`wlan_hosted_network_reason_insufficient_resources` 服务资源不足。
`wlan_hosted_network_reason_elevation_required` 此操作需要提升。
`wlan_hosted_network_reason_read_only` 尝试写入只读数据。
`wlan_hosted_network_reason_persistence_failed` 数据暂留失败。
`wlan_hosted_network_reason_crypt_error` 发生加密错误。
`wlan_hosted_network_reason_impersonation` 用户模拟失败。
`wlan_hosted_network_reason_stop_before_start` 生成了错误的函数调用序列。
`wlan_hosted_network_reason_interface_available` 无线接口已可用。
`wlan_hosted_network_reason_interface_unavailable` 无线接口不可用。每当无线托管网络的网络状态 wlan_hosted_network_unavailable时，无线托管网络函数将返回此原因代码。例如，如果域上的组策略禁用了无线托管网络，则无线托管网络的网络状态 wlan_hosted_network_unavailable。在这种情况下，对 WlanHostedNetworkStartUsing 或 WlanHostedNetworkForceStart 函数的任何调用都将返回此原因代码。
`wlan_hosted_network_reason_miniport_stopped` 无线微型端口驱动程序已停止托管网络。
`wlan_hosted_network_reason_miniport_started` 无线微型端口驱动程序状态已更改。
`wlan_hosted_network_reason_incompatible_connection_started` 已启动不兼容的连接。不兼容的连接是指以下情况之一：主工作站适配器上启动即席无线连接。网络监视由应用程序 (网络监视器在主工作站适配器上启动，例如，) 调用 OpCode 参数设置为 wlan_intf_opcode_current_operation_mode 且 pData 参数指向包含DOT11_OPERATION_MODE_NETWORK_MONITOR的 ULONG 的 WlanSetInterface 函数。无线连接在主工作站适配器上以 FIPS 安全模式启动。 FIPS 安全模式是在无线连接的配置文件中指定的。有关详细信息，请参阅 FIPSMode 元素。在主工作站适配器上启动不兼容连接时，Windows 将在基于软件的无线接入点 (AP) 适配器上停止无线托管网络。无线托管网络状态的网络状态将变为wlan_hosted_network_unavailable。
`wlan_hosted_network_reason_incompatible_connection_stopped` 不兼容的连接已停止。以前在主工作站适配器上启动 (wlan_hosted_network_reason_incompatible_connection_started) 不兼容的连接，但不兼容的连接已停止。如果以前由于启动不兼容的连接而停止了无线托管网络，Windows 不会自动重启无线托管网络。应用程序可以通过调用 WlanHostedNetworkStartUsing 或 WlanHostedNetworkForceStart 函数在 AP 适配器上重启无线托管网络。
`wlan_hosted_network_reason_user_action` 发生了由显式用户操作引起的状态更改。
`wlan_hosted_network_reason_client_abort` 由于客户端中止，发生了状态更改。
`wlan_hosted_network_reason_ap_start_failed` 无线托管网络的驱动程序无法启动。
`wlan_hosted_network_reason_peer_arrived` 连接到无线托管网络的对等方。
`wlan_hosted_network_reason_peer_departed` 与无线托管网络断开连接的对等方。
`wlan_hosted_network_reason_peer_timeout` 对等方超时。
`wlan_hosted_network_reason_gp_denied` 组策略拒绝了该操作。
`wlan_hosted_network_reason_service_unavailable` 无线 LAN 服务未运行。
`wlan_hosted_network_reason_device_change` 无线托管网络使用的无线适配器已更改。
`wlan_hosted_network_reason_properties_change` 无线托管网络的属性已更改。
`wlan_hosted_network_reason_virtual_station_blocking_use` 虚拟工作站处于活动状态并阻止操作。
`wlan_hosted_network_reason_service_available_on_virtual_station` 虚拟工作站上提供相同的服务。

注解

WLAN_HOSTED_NETWORK_REASON枚举类型是添加到本机无线 API 的扩展，以支持 Windows 7 及更高版本上的无线托管网络。

WLAN_HOSTED_NETWORK_REASON枚举无线托管网络函数调用失败的可能原因或生成特定无线托管网络通知的原因。

在 Windows 7 及更高版本上，如果计算机上存在支持托管网络的无线适配器，则操作系统将安装虚拟设备。如果计算机具有单个无线网络适配器，此虚拟设备通常会在“网络连接文件夹”中显示为“无线网络连接 2”，设备名称为“Microsoft 虚拟 WiFi 微型端口适配器”。此虚拟设备专门用于执行软接入点 (SoftAP) 连接，并且不存在于 WlanEnumInterfaces 函数返回的列表中。此虚拟设备的生存期与物理无线适配器相关联。如果物理无线适配器处于禁用状态，此虚拟设备也将被删除。

要求


最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
标头	wlanapi.h (包括 Wlanapi.h)