перечисление WLAN_HOSTED_NETWORK_NOTIFICATION_CODE (wlanapi.h)

Статья
03/04/2024

Перечислимый тип WLAN_HOSTED_NETWORK_NOTIFICATION_CODE указывает возможные значения параметра NotificationCode для полученных уведомлений в беспроводной размещенной сети.

Синтаксис

typedef enum _WLAN_HOSTED_NETWORK_NOTIFICATION_CODE {
  wlan_hosted_network_state_change,
  wlan_hosted_network_peer_state_change,
  wlan_hosted_network_radio_state_change
} WLAN_HOSTED_NETWORK_NOTIFICATION_CODE, *PWLAN_HOSTED_NETWORK_NOTIFICATION_CODE;

Константы


`wlan_hosted_network_state_change` Состояние размещенной сети изменилось.
`wlan_hosted_network_peer_state_change` Состояние однорангового узла размещенной сети изменилось.
`wlan_hosted_network_radio_state_change` Состояние радиосвязи размещенной сети изменилось.

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

В WLAN_HOSTED_NETWORK_NOTIFICATION_CODE указываются возможные значения параметра NotificationCode для полученных уведомлений, если параметр NotificationSource WLAN_NOTIFICATION_SOURCE_HNWK в беспроводной размещенной сети.

Начальное значение перечисления WLAN_HOSTED_NETWORK_NOTIFICATION_CODE определяется как L2_NOTIFICATION_CODE_V2_BEGIN, который определен в файле заголовка l2cmn.h . Обратите внимание, что заголовок l2cmn.h автоматически включается в файл заголовка wlanapi.h .

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

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

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

NotificationCode	Описание
wlan_hosted_network_state_change	Элемент pDataструктуры WLAN_NOTIFICATION_DATA должен быть приведен к указателю на структуру WLAN_HOSTED_NETWORK_STATE_CHANGE , а член dwDataSize будет по меньшей мере иметь размер sizeof(WLAN_HOSTED_NETWORK_STATE_CHANGE).
wlan_hosted_network_peer_state_change	Элемент pDataструктуры WLAN_NOTIFICATION_DATA должен быть приведен к указателю на структуру WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE , а член dwDataSize будет по меньшей мере иметь размер sizeof(WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE).
wlan_hosted_network_radio_state_change	Элемент pDataструктуры WLAN_NOTIFICATION_DATA должен быть приведен к указателю на структуру WLAN_HOSTED_NETWORK_RADIO_STATE , а член dwDataSize будет по крайней мере равно размеру sizeof(WLAN_HOSTED_NETWORK_RADIO_STATE ).

Требования

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