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

Статья
08/28/2023

Функция WlanRegisterVirtualStationNotification используется для регистрации и отмены регистрации уведомлений на виртуальной станции.

Синтаксис

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

Параметры

[in] hClientHandle

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

[in] bRegister

Значение типа , указывающее, следует ли получать уведомления на виртуальной станции.

pReserved

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

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

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

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

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

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

Клиентское приложение вызывает функцию WlanRegisterVirtualStationNotification , которая используется для регистрации и отмены регистрации уведомлений на виртуальной станции.

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

По умолчанию клиент приложения не будет получать уведомления на виртуальной станции. Чтобы получить эти уведомления, клиент должен вызвать функцию WlanRegisterVirtualStationNotification с параметром bRegister , установленным в true , а также вызвать функцию WlanRegisterNotification с параметром dwNotifSource , заданным для источников уведомлений для регистрации. Регистрация для получения уведомлений от виртуальной станции действует до тех пор, пока приложение не закроет дескриптор клиента (путем вызова WlanCloseHandle с параметром hClientHandle ), процесс завершится или функция WlanRegisterVirtualStationNotification не будет вызвана с параметром bRegister , для параметра имеет значение FALSE.

В Windows 7 и более поздних версиях операционная система устанавливает виртуальное устройство, если на компьютере присутствует беспроводной адаптер с поддержкой размещенной сети. Это виртуальное устройство обычно отображается в папке "Сетевые подключения" как "Беспроводное сетевое подключение 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

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

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

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

WlanCloseHandle

WlanRegisterNotification

Share via