структура WLAN_MSM_NOTIFICATION_DATA (wlanapi.h)
Структура WLAN_MSM_NOTIFICATION_DATA содержит сведения об уведомлениях, связанных с подключением к модулю (MSM).
Синтаксис
typedef struct _WLAN_MSM_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_MAC_ADDRESS dot11MacAddr;
BOOL bSecurityEnabled;
BOOL bFirstPeer;
BOOL bLastPeer;
WLAN_REASON_CODE wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;
Члены
wlanConnectionMode
Значение WLAN_CONNECTION_MODE , указывающее режим подключения.
strProfileName[WLAN_MAX_NAME_LENGTH]
Имя профиля, используемого для подключения. WLAN_MAX_NAME_LENGTH — 256. В именах профилей учитывается регистр. Эта строка должна заканчиваться значением NULL.
dot11Ssid
Структура DOT11_SSID , содержащая SSID связи.
dot11BssType
Значение DOT11_BSS_TYPE , указывающее тип сети BSS.
dot11MacAddr
DOT11_MAC_ADDRESS, указывающий MAC-адрес однорангового узла или точки доступа.
bSecurityEnabled
Указывает, включена ли безопасность для этого подключения. Если задано значение TRUE, безопасность включена.
bFirstPeer
Указывает, присоединяется ли одноранговый узел первым к нерегламентированной сети, созданной компьютером. При значении TRUE одноранговый узел первым присоединяется.
После присоединения первого однорангового узла к сети состояние интерфейса компьютера, создавшего нерегламентарную сеть, изменится с wlan_interface_state_ad_hoc_network_formed на wlan_interface_state_connected.
bLastPeer
Указывает, выходит ли одноранговый узел последним из нерегламентированной сети, созданной компьютером. Если значение РАВНО TRUE, одноранговый узел остается последним. После того как последний одноранговый узел покинет сеть, состояние интерфейса компьютера, создавшего нерегламентированное сетевое подключение, изменится с wlan_interface_state_connected на wlan_interface_state_ad_hoc_network_formed.
wlanReasonCode
WLAN_REASON_CODE, указывающий причину сбоя операции. Если операция выполнена успешно, это поле имеет значение WLAN_REASON_CODE_SUCCESS. В противном случае это поле указывает причину сбоя.
Комментарии
Функция WlanRegisterNotification используется приложением для регистрации и отмены регистрации уведомлений на всех беспроводных интерфейсах. При регистрации для уведомлений приложение должно предоставить функцию обратного вызова, на которую указывает параметр funcCallback , передаваемый в функцию WlanRegisterNotification . Прототипом этой функции обратного вызова является WLAN_NOTIFICATION_CALLBACK. Эта функция обратного вызова будет получать уведомления, зарегистрированные в параметре dwNotifSource , переданном в функцию WlanRegisterNotification .
Функция обратного вызова вызывается с указателем на структуру WLAN_NOTIFICATION_DATA в качестве первого параметра, содержащего подробные сведения об уведомлении.
Если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATA , полученный функцией обратного вызова, является WLAN_NOTIFICATION_SOURCE_MSM, то полученное уведомление является уведомлением модуля мультимедиа (MSM). Элемент NotificationCode структуры WLAN_NOTIFICATION_DATA , передаваемой в функцию WLAN_NOTIFICATION_CALLBACK , определяет интерпретацию элемента pDataструктуры WLAN_NOTIFICATION_DATA . Для некоторых из этих уведомлений в элементе pDataструктуры WLAN_NOTIFICATION_DATA возвращается структура WLAN_MSM_NOTIFICATION_DATA.
Дополнительные сведения об этих уведомлениях см. в справочнике по перечислению WLAN_NOTIFICATION_MSM .
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Верхняя часть | wlanapi.h |