WLAN_NOTIFICATION_CALLBACK função de retorno de chamada (wlanapi.h)
O protótipo da função de retorno de chamada WLAN_NOTIFICATION_CALLBACK define o tipo de função de retorno de chamada de notificação.
Sintaxe
WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;
void WlanNotificationCallback(
PWLAN_NOTIFICATION_DATA unnamedParam1,
PVOID unnamedParam2
)
{...}
Parâmetros
unnamedParam1
Um ponteiro para uma estrutura WLAN_NOTIFICATION_DATA que contém as informações de notificação.
Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Somente as notificações de wlan_notification_acm_connection_complete e wlan_notification_acm_disconnected estão disponíveis.
unnamedParam2
Um ponteiro para as informações de contexto fornecidas pelo cliente quando ele se registrou para a notificação.
Retornar valor
Nenhum
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. A função de retorno de chamada também recebe um segundo parâmetro que contém um ponteiro para o contexto do cliente passado no parâmetro pCallbackContext para a função WlanRegisterNotification . Esse contexto de cliente poderá ser um ponteiro NULL se for isso que foi passado para a função WlanRegisterNotification .
Depois de registrada, a função de retorno de chamada será chamada sempre que uma notificação estiver disponível até que o cliente cancele o registro ou feche o identificador.
Qualquer registro para receber notificações será desfeito automaticamente se o aplicativo de chamada fechar seu identificador de chamada (chamando WlanCloseHandle com o parâmetro hClientHandle ) usado para registrar notificações com a função WlanRegisterNotification ou se o processo terminar.
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 obter mais informações sobre essas notificações, consulte a referência de enumeração WLAN_NOTIFICATION_ACM .
Se o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA recebida pela função de retorno de chamada for WLAN_NOTIFICATION_SOURCE_HNWK, a notificação recebida será uma notificação de Rede Hospedada sem fio com suporte no Windows 7 e no Windows Server 2008 R2 com o Serviço de LAN Sem Fio instalado. 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 obter mais informações sobre essas notificações, consulte a referência de enumeração WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .
Se o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA recebida pela função de retorno de chamada for WLAN_NOTIFICATION_SOURCE_IHV, a notificação recebida será uma notificação de IHV (fornecedor independente de hardware). 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 , que é específica do IHV.
Se o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA recebida pela função de retorno de chamada for WLAN_NOTIFICATION_SOURCE_ONEX, a notificação recebida será uma notificação de módulo 802.1X. 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 obter mais informações sobre essas notificações, consulte a referência de enumeração ONEX_NOTIFICATION_TYPE .
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 da estrutura de WLAN_NOTIFICATION_DATA . Para obter mais informações sobre essas notificações, consulte a referência de enumeração WLAN_NOTIFICATION_MSM .
Se o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA recebida pela função de retorno de chamada for WLAN_NOTIFICATION_SOURCE_SECURITY, a notificação recebida será uma notificação de segurança. Nenhuma notificação está definida no momento para WLAN_NOTIFICATION_SOURCE_SECURITY.
Windows XP com SP3 e API lan sem fio para Windows XP com SP2: As notificações são tratadas pelo serviço Netman. Se o serviço Netman estiver desabilitado ou indisponível, as notificações não serão recebidas. Se uma notificação não for recebida dentro de um período razoável, um aplicativo deverá atingir o tempo limite e consultar o estado da interface atual.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wlanapi.h |
| Redistribuível | API de LAN sem fio para Windows XP com SP2 |