структура 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 .
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) |