Condividi tramite


WLAN_MSM_NOTIFICATION_DATA struttura (wlanapi.h)

La struttura WLAN_MSM_NOTIFICATION_DATA contiene informazioni sulle notifiche correlate al modulo specifico del supporto (MSM).

Sintassi

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;

Members

wlanConnectionMode

Valore WLAN_CONNECTION_MODE che specifica la modalità della connessione.

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.

dot11MacAddr

DOT11_MAC_ADDRESS che specifica l'indirizzo MAC del peer o del punto di accesso.

bSecurityEnabled

Indica se la sicurezza è abilitata per questa connessione. Se TRUE, la sicurezza è abilitata.

bFirstPeer

Indica se il peer è il primo a partecipare alla rete ad hoc creata dal computer. Se TRUE, il peer è il primo a partecipare.

Dopo che il primo peer partecipa alla rete, lo stato dell'interfaccia del computer che ha creato la rete ad hoc cambia da wlan_interface_state_ad_hoc_network_formed a wlan_interface_state_connected.

bLastPeer

Indica se il peer è l'ultimo a lasciare la rete ad hoc creata dal computer. Se TRUE, il peer è l'ultimo da lasciare. Dopo l'ultimo peer lascia la rete, lo stato dell'interfaccia del computer che ha creato la rete ad hoc cambia da wlan_interface_state_connected a wlan_interface_state_ad_hoc_network_formed.

wlanReasonCode

WLAN_REASON_CODE che indica il motivo di un errore dell'operazione. Se l'operazione ha esito positivo, questo campo ha un valore di WLAN_REASON_CODE_SUCCESS. In caso contrario, questo campo indica il motivo dell'errore.

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_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 alcune di queste notifiche, viene restituita una struttura di WLAN_MSM_NOTIFICATION_DATA nel membro pData della struttura di WLAN_NOTIFICATION_DATA .

Per altre informazioni su queste notifiche, vedere il riferimento all'enumerazione WLAN_NOTIFICATION_MSM .

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione wlanapi.h

Vedi anche

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification