Método IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Esse método de notificação é chamado pelo serviço de Banda Larga Móvel para indicar a conclusão de uma verificação de rede.
Sintaxe
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parâmetros
[in] newInterface
Um IMbnInterface que representa um dispositivo no qual essa operação foi executada.
[in] requestID
A ID da solicitação atribuída pelo serviço de Banda Larga Móvel para essa notificação.
[in] status
O status de conclusão da operação
Um aplicativo de chamada pode esperar um dos valores a seguir.
S_OK
A operação foi bem-sucedida.
E_MBN_RADIO_POWER_OFF
Não é possível obter uma lista de rede visível porque o rádio do dispositivo está desativado. O aplicativo pode emitir uma solicitação de verificação de rede quando recebe a notificação ativada por rádio.
E_MBN_DEVICE_BUSY
O dispositivo está ocupado e não pode executar uma operação de verificação de rede no momento. Isso é retornado por dispositivos que não dão suporte a uma operação de verificação de rede quando ela tem uma conexão de dados estabelecida.
E_MBN_ALREADY_ACTIVE
Uma operação de verificação de rede já está em andamento.
Valor retornado
Esse método deve retornar S_OK.
Comentários
Se a operação for concluída com êxito, ou seja, quando status for S_OK, o serviço de Banda Larga Móvel atualizou com êxito a lista armazenada em cache de provedores visíveis. Um aplicativo pode chamar o método GetVisibleProviders do IMbnInterface passado para obter a lista de provedores visíveis.
Se vários aplicativos registrados para notificações, esse método será chamado em todos os aplicativos registrados. Isso significa que um aplicativo que não iniciou a operação de atualização receberá uma notificação.
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |