функция обратного вызова WLAN_NOTIFICATION_CALLBACK (wlanapi.h)

Статья
08/28/2023

Прототип функции обратного вызова WLAN_NOTIFICATION_CALLBACK определяет тип функции обратного вызова уведомления.

Синтаксис

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

void WlanNotificationCallback(
  PWLAN_NOTIFICATION_DATA unnamedParam1,
  PVOID unnamedParam2
)
{...}

Параметры

unnamedParam1

Указатель на структуру WLAN_NOTIFICATION_DATA , содержащую сведения об уведомлении.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Доступны только уведомления wlan_notification_acm_connection_complete и wlan_notification_acm_disconnected.

unnamedParam2

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

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

None

Remarks

Функция WlanRegisterNotification используется приложением для регистрации и отмены регистрации уведомлений на всех беспроводных интерфейсах. При регистрации для уведомлений приложение должно предоставить функцию обратного вызова, на которую указывает параметр funcCallback , передаваемый в функцию WlanRegisterNotification . Прототипом этой функции обратного вызова является WLAN_NOTIFICATION_CALLBACK. Эта функция обратного вызова будет получать уведомления, зарегистрированные в параметре dwNotifSource , переданном в функцию WlanRegisterNotification .

Функция обратного вызова вызывается с указателем на структуру WLAN_NOTIFICATION_DATA в качестве первого параметра, содержащего подробные сведения об уведомлении. Функция обратного вызова также получает второй параметр, содержащий указатель на контекст клиента, переданный в параметре pCallbackContext в функцию WlanRegisterNotification . Этот контекст клиента может быть указателем NULL , если это то, что было передано в функцию WlanRegisterNotification .

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

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

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_ACM, то полученное уведомление является уведомлением модуля автоматической настройки. Элемент NotificationCode структуры WLAN_NOTIFICATION_DATA , передаваемой в функцию WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA . Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению WLAN_NOTIFICATION_ACM .

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_HNWK, то полученное уведомление является уведомлением беспроводной размещенной сети, поддерживаемым в Windows 7 и Windows Server 2008 R2 с установленной службой беспроводной локальной сети. Элемент NotificationCode структуры WLAN_NOTIFICATION_DATA , передаваемой в функцию WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA . Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_IHV, то полученное уведомление является уведомлением независимого поставщика оборудования (IHV). Элемент NotificationCodeструктуры WLAN_NOTIFICATION_DATA , передаваемой функции WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA , относящегося к IHV.

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_ONEX, то полученное уведомление является уведомлением модуля 802.1X. Элемент NotificationCode структуры WLAN_NOTIFICATION_DATA , передаваемой в функцию WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA . Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению ONEX_NOTIFICATION_TYPE .

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_MSM, то полученное уведомление является уведомлением модуля мультимедиа (MSM). Элемент NotificationCode структуры WLAN_NOTIFICATION_DATA , передаваемой в функцию WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA . Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению WLAN_NOTIFICATION_MSM .

Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_SECURITY, то полученное уведомление является уведомлением безопасности. Уведомления для WLAN_NOTIFICATION_SOURCE_SECURITY в настоящее время не определены.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Уведомления обрабатываются службой Netman. Если служба Netman отключена или недоступна, уведомления не будут получены. Если уведомление не получено в течение разумного периода времени, приложение должно запросить текущее состояние интерфейса.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wlanapi.h
Распространяемые компоненты	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)