WLAN_NOTIFICATION_CALLBACK fonction de rappel (wlanapi.h)

Article
03/04/2024

Le prototype de fonction de rappel WLAN_NOTIFICATION_CALLBACK définit le type de fonction de rappel de notification.

Syntaxe

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

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

Paramètres

unnamedParam1

Pointeur vers une structure WLAN_NOTIFICATION_DATA qui contient les informations de notification.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Seules les notifications wlan_notification_acm_connection_complete et wlan_notification_acm_disconnected sont disponibles.

unnamedParam2

Pointeur vers les informations de contexte fournies par le client lors de son inscription à la notification.

Valeur de retour

None

Remarques

La fonction WlanRegisterNotification est utilisée par une application pour inscrire et annuler l’inscription des notifications sur toutes les interfaces sans fil. Lors de l’inscription aux notifications, une application doit fournir une fonction de rappel pointée vers le paramètre funcCallback passé à la fonction WlanRegisterNotification . Le prototype de cette fonction de rappel est le WLAN_NOTIFICATION_CALLBACK. Cette fonction de rappel recevra des notifications qui ont été inscrites dans le paramètre dwNotifSource transmis à la fonction WlanRegisterNotification .

La fonction de rappel est appelée avec un pointeur vers une structure WLAN_NOTIFICATION_DATA comme premier paramètre qui contient des informations détaillées sur la notification. La fonction de rappel reçoit également un deuxième paramètre qui contient un pointeur vers le contexte client passé dans le paramètre pCallbackContext à la fonction WlanRegisterNotification . Ce contexte client peut être un pointeur NULL si c’est ce qui a été passé à la fonction WlanRegisterNotification .

Une fois inscrite, la fonction de rappel est appelée chaque fois qu’une notification est disponible jusqu’à ce que le client annule ou ferme le handle.

Toute inscription pour recevoir des notifications est automatiquement annulée si l’application appelante ferme son handle d’appel (en appelant WlanCloseHandle avec le paramètre hClientHandle ) utilisé pour s’inscrire aux notifications avec la fonction WlanRegisterNotification ou si le processus se termine.

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_ACM, la notification reçue est une notification de module de configuration automatique. Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure. Pour plus d’informations sur ces notifications, consultez la référence d’énumération WLAN_NOTIFICATION_ACM .

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_HNWK, la notification reçue est une notification de réseau hébergé sans fil prise en charge sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé. Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure. Pour plus d’informations sur ces notifications, consultez la référence d’énumération WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_IHV, la notification reçue est une notification de fournisseur de matériel (IHV) indépendante. Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure, qui est spécifique à l’IHV.

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_ONEX, la notification reçue est une notification de module 802.1X. Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure. Pour plus d’informations sur ces notifications, consultez la référence d’énumération ONEX_NOTIFICATION_TYPE .

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_MSM, la notification reçue est une notification msm (Media Specific Module). Le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA passée à la fonction WLAN_NOTIFICATION_CALLBACK détermine l’interprétation du membre pData de WLAN_NOTIFICATION_DATA structure. Pour plus d’informations sur ces notifications, consultez la référence d’énumération WLAN_NOTIFICATION_MSM .

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçue par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_SECURITY, la notification reçue est une notification de sécurité. Aucune notification n’est actuellement définie pour WLAN_NOTIFICATION_SOURCE_SECURITY.

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Les notifications sont gérées par le service Netman. Si le service Netman est désactivé ou indisponible, aucune notification ne sera reçue. Si aucune notification n’est reçue dans un délai raisonnable, une application doit expirer et interroger l’état actuel de l’interface.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h
Composant redistribuable	API LAN sans fil pour Windows XP avec SP2