Функция WlanHostedNetworkQueryStatus (wlanapi.h)
Функция WlanHostedNetworkQueryStatus запрашивает текущее состояние беспроводной размещенной сети.
Синтаксис
DWORD WlanHostedNetworkQueryStatus(
[in] HANDLE hClientHandle,
[out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
PVOID pvReserved
);
Параметры
[in] hClientHandle
Дескриптор сеанса клиента, возвращенный предыдущим вызовом функции WlanOpenHandle .
[out] ppWlanHostedNetworkStatus
Для входных данных этот параметр должен иметь значение NULL.
На выходе этот параметр получает указатель на текущее состояние беспроводной размещенной сети, если вызов функции WlanHostedNetworkQueryStatus выполнен успешно. Текущее состояние возвращается в структуре WLAN_HOSTED_NETWORK_STATUS .
pvReserved
Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов возврата.
| Код возврата | Описание |
|---|---|
|
Недопустимый дескриптор. Эта ошибка возвращается, если дескриптор, указанный в параметре hClientHandle , не найден в таблице дескрипторов. |
|
Неправильный параметр. Эта ошибка возвращается при возникновении любого из следующих условий:
|
|
Ресурс находится в неправильном состоянии для выполнения запрошенной операции. Это может произойти, если беспроводная размещенная сеть находилась в процессе завершения работы. |
|
Служба не запущена. Эта ошибка возвращается, если служба автонастройки WLAN не запущена. |
|
Различные коды RPC и другие коды ошибок. Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки. |
Комментарии
Функция WlanHostedNetworkQueryStatus — это расширение собственных беспроводных API, добавленных для поддержки беспроводной сети в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети.
Клиентское приложение вызывает функцию WlanHostedNetworkQueryStatus для запроса текущего состояния беспроводной размещенной сети. Эта функция не изменяет состояние беспроводной размещенной сети.
Если функция выполняется успешно, параметр ppWlanHostedNetworkStatus указывает на WLAN_HOSTED_NETWORK_STATUS структуру с текущим состоянием. Память, используемая для возвращаемой структуры WLAN_HOSTED_NETWORK_STATUS , должна быть освобождена после использования путем вызова функции WlanFreeMemory .
Любой пользователь может вызвать функцию WlanHostedNetworkQueryStatus для запроса размещенной сети. Однако возможность включения беспроводной размещенной сети может быть ограничена групповой политикой в домене.
В 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 |
См. также раздел
Сведения о беспроводной размещенной сети
Использование беспроводной размещенной сети и общего доступа к интернет-подключению
WlanHostedNetworkQueryProperty