WLAN_NOTIFICATION_CALLBACK funzione di callback (wlanapi.h)

Articolo
03/04/2024

Il prototipo di funzione di callback WLAN_NOTIFICATION_CALLBACK definisce il tipo di funzione di callback di notifica.

Sintassi

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

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

Parametri

unnamedParam1

Puntatore a una struttura WLAN_NOTIFICATION_DATA contenente le informazioni di notifica.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Sono disponibili solo le notifiche di wlan_notification_acm_connection_complete e wlan_notification_acm_disconnected.

unnamedParam2

Puntatore alle informazioni sul contesto fornite dal client quando è stato registrato per la notifica.

Valore restituito

nessuno

Osservazioni

La funzione WlanRegisterNotification viene usata da un'applicazione per registrare e annullare la registrazione delle notifiche in tutte le interfacce wireless. Quando si registrano le notifiche, un'applicazione deve fornire una funzione di callback puntata dal parametro funcCallback passato alla funzione WlanRegisterNotification . Il prototipo per questa funzione di callback è il WLAN_NOTIFICATION_CALLBACK. Questa funzione di callback riceverà notifiche registrate nel parametro dwNotifSource passato alla funzione WlanRegisterNotification .

La funzione di callback viene chiamata con un puntatore a una struttura WLAN_NOTIFICATION_DATA come primo parametro contenente informazioni dettagliate sulla notifica. La funzione di callback riceve anche un secondo parametro che contiene un puntatore al contesto client passato nel parametro pCallbackContext alla funzione WlanRegisterNotification . Questo contesto client può essere un puntatore NULL se ciò è stato passato alla funzione WlanRegisterNotification .

Una volta registrata, la funzione di callback verrà chiamata ogni volta che una notifica è disponibile fino a quando il client non esegue la registrazione o chiude l'handle.

Qualsiasi registrazione per ricevere notifiche viene annullata automaticamente se l'applicazione chiamante chiude il relativo handle chiamante (chiamando WlanCloseHandle con il parametro hClientHandle ) usato per registrare le notifiche con la funzione WlanRegisterNotification o se il processo termina.

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_ACM, la notifica ricevuta è una notifica del modulo di configurazione automatica. Il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA passata alla funzione WLAN_NOTIFICATION_CALLBACK determina l'interpretazione del membro pDatadella struttura WLAN_NOTIFICATION_DATA. Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione WLAN_NOTIFICATION_ACM.

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_HNWK, la notifica ricevuta è una notifica di rete ospitata wireless supportata in Windows 7 e in Windows Server 2008 R2 con il servizio LAN wireless installato. Il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA passata alla funzione WLAN_NOTIFICATION_CALLBACK determina l'interpretazione del membro pDatadella struttura WLAN_NOTIFICATION_DATA. Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_IHV, la notifica ricevuta è un fornitore hardware indipendente (IHV). Il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA passato alla funzione WLAN_NOTIFICATION_CALLBACK determina l'interpretazione del membro pDatadella struttura WLAN_NOTIFICATION_DATA, specifica per l'IHV.

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_ONEX, la notifica ricevuta è una notifica del modulo 802.1X. Il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA passata alla funzione WLAN_NOTIFICATION_CALLBACK determina l'interpretazione del membro pDatadella struttura WLAN_NOTIFICATION_DATA. Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione ONEX_NOTIFICATION_TYPE .

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_MSM, la notifica ricevuta è una notifica specifica del supporto (MSM). Il membro NotificationCode della struttura WLAN_NOTIFICATION_DATA passata alla funzione WLAN_NOTIFICATION_CALLBACK determina l'interpretazione del membro pDatadella struttura WLAN_NOTIFICATION_DATA. Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione WLAN_NOTIFICATION_MSM .

Se il membro NotificationSource della struttura WLAN_NOTIFICATION_DATA ricevuta dalla funzione di callback è WLAN_NOTIFICATION_SOURCE_SECURITY, la notifica ricevuta è una notifica di sicurezza. Non sono attualmente definite notifiche per WLAN_NOTIFICATION_SOURCE_SECURITY.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Le notifiche vengono gestite dal servizio Netman. Se il servizio Netman è disabilitato o non disponibile, le notifiche non verranno ricevute. Se una notifica non viene ricevuta entro un periodo di tempo ragionevole, un'applicazione deve eseguire il timeout e eseguire una query sullo stato dell'interfaccia corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wlanapi.h
Componente ridistribuibile	API LAN wireless per Windows XP con SP2