estrutura WLAN_CONNECTION_NOTIFICATION_DATA (wlanapi.h)

A estrutura WLAN_CONNECTION_NOTIFICATION_DATA contém informações sobre notificações relacionadas à conexão.

Sintaxe

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;

Membros

wlanConnectionMode

Um valor WLAN_CONNECTION_MODE que especifica o modo da conexão.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Há suporte apenas para o valor de wlan_connection_mode_profile .

strProfileName[WLAN_MAX_NAME_LENGTH]

O nome do perfil usado para a conexão. WLAN_MAX_NAME_LENGTH é 256. Os nomes de perfil diferenciam maiúsculas de minúsculas. Essa cadeia de caracteres deve ser terminada em NULL.

dot11Ssid

Uma estrutura DOT11_SSID que contém o SSID da associação.

dot11BssType

Um valor DOT11_BSS_TYPE que indica o tipo de rede BSS.

bSecurityEnabled

Indica se a segurança está habilitada para essa conexão. Se TRUE, a segurança estará habilitada.

wlanReasonCode

Um WLAN_REASON_CODE que indica o motivo de uma falha de operação. Esse campo tem um valor de WLAN_REASON_CODE_SUCCESS para todas as notificações relacionadas à conexão, exceto wlan_notification_acm_connection_complete. Se a conexão falhar, esse campo indicará o motivo da falha.

dwFlags

Um conjunto de sinalizadores que fornecem informações adicionais para a conexão de rede.

Esse membro pode ser um dos seguintes valores definidos no arquivo de cabeçalho Wlanapi.h .

strProfileXml[1]

Esse campo contém a apresentação XML do perfil usado para descoberta, se a conexão for bem-sucedida.

Comentários

A função WlanRegisterNotification é usada por um aplicativo para registrar e cancelar o registro de notificações em todas as interfaces sem fio. Ao se registrar para notificações, um aplicativo deve fornecer uma função de retorno de chamada apontada pelo parâmetro funcCallback passado para a função WlanRegisterNotification . O protótipo dessa função de retorno de chamada é o WLAN_NOTIFICATION_CALLBACK. Essa função de retorno de chamada receberá notificações que foram registradas no parâmetro dwNotifSource passado para a função WlanRegisterNotification .

A função de retorno de chamada é chamada com um ponteiro para uma estrutura WLAN_NOTIFICATION_DATA como o primeiro parâmetro que contém informações detalhadas sobre a notificação.

Se o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA recebida pela função de retorno de chamada for WLAN_NOTIFICATION_SOURCE_ACM, a notificação recebida será uma notificação do módulo de configuração automática. O membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA passada para a função WLAN_NOTIFICATION_CALLBACK determina a interpretação do membro pData da estrutura de WLAN_NOTIFICATION_DATA . Para algumas dessas notificações, uma estrutura WLAN_CONNECTION_NOTIFICATION_DATA é retornada no membro pData da estrutura de WLAN_NOTIFICATION_DATA .

Para obter mais informações sobre essas notificações, consulte a referência de enumeração WLAN_NOTIFICATION_ACM .

Requisitos

Confira também

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification