перечисление 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` Запущено несовместимое подключение. Несовместимое подключение относится к одному из следующих случаев: На адаптере основной станции запускается нерегламентированное беспроводное подключение. Сетевой мониторинг запускается на адаптере основной станции приложением (например, сетевым монитором), которое вызывает функцию WlanSetInterface с параметром OpCode , установленным на wlan_intf_opcode_current_operation_mode , а параметр pData указывает на ULONG, содержащий DOT11_OPERATION_MODE_NETWORK_MONITOR. Беспроводное подключение запускается в безопасном режиме FIPS на адаптере основной станции. Безопасный режим FIPS указывается в профиле беспроводного подключения. Дополнительные сведения см. в разделе Элемент FIPSMode. Windows остановит беспроводную размещенную сеть на адаптере программной точки доступа (AP) при запуске несовместимого подключения к адаптеру основной станции. Состояние сети беспроводной размещенной сети станет wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` Несовместимое подключение остановлено. Ранее на адаптере основной станции (wlan_hosted_network_reason_incompatible_connection_started) было запущено несовместимое подключение, но несовместимое подключение было остановлено. Если беспроводная размещенная сеть ранее была остановлена в результате запуска несовместимого подключения, Windows не будет автоматически перезапускать беспроводную размещенную сеть. Приложения могут перезапустить беспроводную размещенную сеть на адаптере AP, вызвав функцию WlanHostedNetworkStartUsing или WlanHostedNetworkForceStart .
`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 является расширением собственных беспроводных API, добавленных для поддержки беспроводной размещенной сети в Windows 7 и более поздних версиях.

В WLAN_HOSTED_NETWORK_REASON перечислены возможные причины сбоя вызова функции беспроводной размещенной сети или причины, по которым было создано определенное уведомление беспроводной размещенной сети.

В Windows 7 и более поздних версиях операционная система устанавливает виртуальное устройство, если на компьютере присутствует беспроводной адаптер с поддержкой размещенной сети. Это виртуальное устройство обычно отображается в папке "Сетевые подключения" как "Беспроводное сетевое подключение 2" с именем устройства "Microsoft Virtual WiFi Miniport adapter", если компьютер имеет один беспроводной сетевой адаптер. Это виртуальное устройство используется исключительно для выполнения подключений к точкам доступа программного обеспечения (SoftAP) и отсутствует в списке, возвращаемом функцией WlanEnumInterfaces . Время существования этого виртуального устройства привязано к физическому беспроводному адаптеру. Если физический беспроводной адаптер отключен, это виртуальное устройство также будет удалено.

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхняя часть	wlanapi.h (включая Wlanapi.h)