WLAN_NOTIFICATION_CALLBACK função de retorno de chamada (wlanapi.h)

Artigo
08/28/2023

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