énumération WLAN_HOSTED_NETWORK_NOTIFICATION_CODE (wlanapi.h)

Article
08/28/2023

Le WLAN_HOSTED_NETWORK_NOTIFICATION_CODE type énuméré spécifie les valeurs possibles du paramètre NotificationCode pour les notifications reçues sur le réseau hébergé sans fil.

Syntax

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;

Constantes


`wlan_hosted_network_state_change` L’état du réseau hébergé a changé.
`wlan_hosted_network_peer_state_change` L’état d’homologue du réseau hébergé a changé.
`wlan_hosted_network_radio_state_change` L’état radio du réseau hébergé a changé.

Remarques

Le WLAN_HOSTED_NETWORK_NOTIFICATION_CODE type énuméré est une extension aux API sans fil natives ajoutées pour prendre en charge le réseau hébergé sans fil sur Windows 7 et Windows Server 2008 R2 avec le service LAN sans fil installé.

Le WLAN_HOSTED_NETWORK_NOTIFICATION_CODE spécifie les valeurs possibles pour le paramètre NotificationCode pour les notifications reçues lorsque le paramètre NotificationSource est WLAN_NOTIFICATION_SOURCE_HNWK sur le réseau hébergé sans fil.

La valeur de départ de l’énumération WLAN_HOSTED_NETWORK_NOTIFICATION_CODE est définie comme L2_NOTIFICATION_CODE_V2_BEGIN, qui est définie dans le fichier d’en-tête l2cmn.h . Notez que l’en-tête l2cmn.h est automatiquement inclus par le fichier d’en-tête wlanapi.h .

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 reçoit des notifications qui ont été inscrites dans le paramètre dwNotifSource passé à 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 .

Si le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA reçu par la fonction de rappel est WLAN_NOTIFICATION_SOURCE_HNWK, la notification reçue est une notification réseau hébergé sans fil. 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.

NotificationCode	Description
wlan_hosted_network_state_change	Le membre pData de WLAN_NOTIFICATION_DATA structure doit être converti en pointeur vers une structure WLAN_HOSTED_NETWORK_STATE_CHANGE et le membre dwDataSize est au moins aussi grand que sizeof(WLAN_HOSTED_NETWORK_STATE_CHANGE).
wlan_hosted_network_peer_state_change	le membre pData de WLAN_NOTIFICATION_DATA structure doit être converti en pointeur vers une structure WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE et le membre dwDataSize est au moins aussi grand que sizeof(WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE).
wlan_hosted_network_radio_state_change	le membre pData de WLAN_NOTIFICATION_DATA structure doit être converti en pointeur vers une structure WLAN_HOSTED_NETWORK_RADIO_STATE et le membre dwDataSize serait au moins aussi grand que sizeof(WLAN_HOSTED_NETWORK_RADIO_STATE ).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	wlanapi.h (inclure Wlanapi.h)