estrutura WLAN_MSM_NOTIFICATION_DATA (wlanapi.h)
A estrutura de WLAN_MSM_NOTIFICATION_DATA contém informações sobre notificações relacionadas à conexão msm (módulo específico de mídia).
Sintaxe
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;
Membros
wlanConnectionMode
Um valor WLAN_CONNECTION_MODE que especifica o modo da conexão.
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.
dot11MacAddr
Um DOT11_MAC_ADDRESS que especifica o endereço MAC do ponto de acesso ou par.
bSecurityEnabled
Indica se a segurança está habilitada para essa conexão. Se TRUE, a segurança estará habilitada.
bFirstPeer
Indica se o par é o primeiro a ingressar na rede ad hoc criada pelo computador. Se TRUE, o par será o primeiro a ingressar.
Depois que o primeiro par ingressa na rede, o estado da interface do computador que criou a rede ad hoc muda de wlan_interface_state_ad_hoc_network_formed para wlan_interface_state_connected.
bLastPeer
Indica se o par é o último a deixar a rede ad hoc criada pelo computador. Se TRUE, o par será o último a sair. Depois que o último par sai da rede, o estado da interface do computador que criou a rede ad hoc muda de wlan_interface_state_connected para wlan_interface_state_ad_hoc_network_formed.
wlanReasonCode
Um WLAN_REASON_CODE que indica o motivo de uma falha na operação. Se a operação for bem-sucedida, esse campo terá um valor de WLAN_REASON_CODE_SUCCESS. Caso contrário, esse campo indica o motivo da falha.
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 passadas 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_MSM, a notificação recebida será uma notificação msm (módulo específico de mídia). O membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA passada para a função WLAN_NOTIFICATION_CALLBACK determina a interpretação do membro pData de WLAN_NOTIFICATION_DATA estrutura. Para algumas dessas notificações, uma estrutura WLAN_MSM_NOTIFICATION_DATA é retornada no membro pData da estrutura WLAN_NOTIFICATION_DATA .
Para obter mais informações sobre essas notificações, consulte a referência de enumeração WLAN_NOTIFICATION_MSM .
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho | wlanapi.h |