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

структура WLAN_CONNECTION_NOTIFICATION_DATA (wlanapi.h)

  • Статья

Структура WLAN_CONNECTION_NOTIFICATION_DATA содержит сведения об уведомлениях, связанных с подключением.

Синтаксис

typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
  WLAN_CONNECTION_MODE wlanConnectionMode;
  WCHAR                strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID           dot11Ssid;
  DOT11_BSS_TYPE       dot11BssType;
  BOOL                 bSecurityEnabled;
  WLAN_REASON_CODE     wlanReasonCode;
  DWORD                dwFlags;
  WCHAR                strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;

Члены

wlanConnectionMode

Значение WLAN_CONNECTION_MODE , указывающее режим подключения.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Поддерживается только значение wlan_connection_mode_profile .

strProfileName[WLAN_MAX_NAME_LENGTH]

Имя профиля, используемого для подключения. WLAN_MAX_NAME_LENGTH — 256. В именах профилей учитывается регистр. Эта строка должна заканчиваться значением NULL.

dot11Ssid

Структура DOT11_SSID , содержащая SSID связи.

dot11BssType

Значение DOT11_BSS_TYPE , указывающее тип сети BSS.

bSecurityEnabled

Указывает, включена ли безопасность для этого подключения. Если задано значение TRUE, безопасность включена.

wlanReasonCode

WLAN_REASON_CODE, указывающий причину сбоя операции. Это поле имеет значение WLAN_REASON_CODE_SUCCESS для всех уведомлений, связанных с подключением, за исключением wlan_notification_acm_connection_complete. Если подключение завершается сбоем, в этом поле указывается причина сбоя.

dwFlags

Набор флагов, предоставляющих дополнительные сведения о сетевом подключении.

Этот элемент может быть одним из следующих значений, определенных в файле заголовка Wlanapi.h .

Значение Значение
WLAN_CONNECTION_NOTIFICATION_ADHOC_NETWORK_FORMED
 Указывает, что создана сеть adhoc.
WLAN_CONNECTION_NOTIFICATION_CONSOLE_USER_PROFILE
 Указывает, что для подключения используется профиль пользователя, принадлежащий пользователю консоли. Пользователи, не являющиеся консольными, не смогут видеть профиль в списке профилей.

strProfileXml[1]

Это поле содержит XML-представление профиля, используемого для обнаружения, в случае успешного подключения.

Комментарии

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

Функция обратного вызова вызывается с указателем на структуру WLAN_NOTIFICATION_DATA в качестве первого параметра, содержащего подробные сведения об уведомлении.

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

Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению WLAN_NOTIFICATION_ACM .

Требования

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

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

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification