WLAN_CONNECTION_NOTIFICATION_DATA struttura (wlanapi.h)
La struttura WLAN_CONNECTION_NOTIFICATION_DATA contiene informazioni sulle notifiche correlate alla connessione.
Sintassi
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;
Members
wlanConnectionMode
Valore WLAN_CONNECTION_MODE che specifica la modalità della connessione.
Windows XP con SP3 e API LAN wireless per Windows XP con SP2: È supportato solo il valore wlan_connection_mode_profile .
strProfileName[WLAN_MAX_NAME_LENGTH]
Nome del profilo utilizzato per la connessione. WLAN_MAX_NAME_LENGTH è 256. I nomi dei profili sono distinzione tra maiuscole e minuscole. Questa stringa deve essere terminata con null.
dot11Ssid
Struttura DOT11_SSID che contiene il SSID dell'associazione.
dot11BssType
Valore DOT11_BSS_TYPE che indica il tipo di rete BSS.
bSecurityEnabled
Indica se la sicurezza è abilitata per questa connessione. Se TRUE, la sicurezza è abilitata.
wlanReasonCode
WLAN_REASON_CODE che indica il motivo di un errore dell'operazione. Questo campo ha un valore di WLAN_REASON_CODE_SUCCESS per tutte le notifiche correlate alla connessione tranne wlan_notification_acm_connection_complete. Se la connessione ha esito negativo, questo campo indica il motivo dell'errore.
dwFlags
Set di flag che forniscono informazioni aggiuntive per la connessione di rete.
Questo membro può essere uno dei valori seguenti definiti nel file di intestazione Wlanapi.h .
strProfileXml[1]
Questo campo contiene la presentazione XML del profilo usato per l'individuazione, se la connessione ha esito positivo.
Commenti
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.
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 alcune di queste notifiche, viene restituita una struttura WLAN_CONNECTION_NOTIFICATION_DATA nel membro pData della struttura di WLAN_NOTIFICATION_DATA .
Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione WLAN_NOTIFICATION_ACM.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista, Windows XP con SP3 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | wlanapi.h |
| Componente ridistribuibile | API LAN wireless per Windows XP con SP2 |