Поделиться через


Функция WlanHostedNetworkForceStop (wlanapi.h)

Функция WlanHostedNetworkForceStop переводит беспроводную размещенную сеть в wlan_hosted_network_idle , не связывая запрос с вызывающим дескриптором приложения.

Синтаксис

DWORD WlanHostedNetworkForceStop(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

Параметры

[in] hClientHandle

Дескриптор сеанса клиента, возвращенный предыдущим вызовом функции WlanOpenHandle .

[out, optional] pFailReason

Необязательный указатель на значение, которое получает причину сбоя, если вызов функции WlanHostedNetworkForceStop завершается сбоем. Возможные значения для причины сбоя относятся к типу перечисления WLAN_HOSTED_NETWORK_REASON , определенному в файле заголовка Wlanapi.h .

pvReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.

Код возврата Описание
ERROR_INVALID_HANDLE
Недопустимый дескриптор. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов.
ERROR_INVALID_PARAMETER
Неправильный параметр. Эта ошибка возвращается при возникновении любого из следующих условий:
  • hClientHandle имеет значение NULL.
  • pvReserved не равно NULL.
ERROR_INVALID_STATE
Ресурс находится в неправильном состоянии для выполнения запрошенной операции.
ERROR_SERVICE_NOT_ACTIVE
Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена.
Другое
Различные коды RPC и другие коды ошибок. Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Комментарии

Функция WlanHostedNetworkForceStop — это расширение собственных беспроводных API, добавленных для поддержки беспроводной сети в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети.

Клиентское приложение вызывает функцию WlanHostedNetworkForceStop , чтобы принудительно остановить размещенную сеть и перевести беспроводную размещенную сеть на wlan_hosted_network_idle , не связывая запрос с вызывающим дескриптором приложения. Клиент обычно вызывает функцию WlanHostedNetworkForceStop , чтобы сопоставить предыдущий успешный вызов функции WlanHostedNetworkForceStart .

Функция WlanHostedNetworkForceStop может завершиться ошибкой, если состояние размещенной сети не wlan_hosted_network_active.

Любое изменение состояния размещенной сети, вызванное этой функцией, не будет автоматически отменено, если вызывающее приложение закрывает свой вызывающий дескриптор (путем вызова WlanCloseHandle с параметром hClientHandle ) или если процесс завершается.

Приложение может вызвать функцию WlanHostedNetworkForceStop , чтобы остановить размещенную сеть после предыдущего вызова WlanHostedNetworkForceStart пользователем системы с повышенными привилегиями, которые приняли повышенные требования к энергопотреблению, связанные с запуском беспроводной размещенной сети в течение длительного времени.

Любой пользователь может вызвать функцию WlanHostedNetworkForceStop , чтобы принудительно остановить размещенную сеть. Однако возможность включения беспроводной размещенной сети может быть ограничена групповой политикой в домене.

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

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header wlanapi.h (включая Wlanapi.h)
Библиотека Wlanapi.lib
DLL Wlanapi.dll

См. также раздел

Сведения о беспроводной размещенной сети

Использование беспроводной размещенной сети и общего доступа к интернет-подключению

WLAN_HOSTED_NETWORK_REASON

WLAN_SECURABLE_OBJECT

WlanCloseHandle

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkQueryStatus

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing

WlanOpenHandle