Método IMbnInterface::GetVisibleProviders (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.
Obtém a lista de provedores visíveis.
Sintaxe
HRESULT GetVisibleProviders(
[out, retval] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
Parâmetros
[out, retval] age
Um ponteiro para o tempo em segundos desde a última atualização da lista de provedores visíveis do dispositivo.
[out, retval] visibleProviders
Ponteiro para uma matriz de estruturas de MBN_PROVIDER que contém a lista de provedores para a interface. Se esse método retornar qualquer valor diferente de S_OK, esse parâmetro será NULL. Caso contrário, após a conclusão, o programa de chamada deve liberar a memória alocada chamando SafeArrayDestroy.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
O método foi concluído com sucesso. visibleProviders contém valores válidos. Com base na idade das informações, o aplicativo de chamada pode decidir emitir uma nova chamada para ScanNetwork. |
|
As informações não estão disponíveis. Uma verificação de rede ativa está em andamento. O aplicativo de chamada pode ser notificado quando os recursos do dispositivo estão disponíveis registrando-se para o método OnScanNetworkComplete de IMbnInterfaceEvents. |
|
O cache da banda larga móvel da lista de rede visível é inválido. O aplicativo de chamada deve chamar ScanNetwork para preencher o cache. |
Comentários
Esse método retorna a lista de provedores visíveis no momento. Os dispositivos CDMA relatarão apenas seu provedor inicial se qualquer rede em sua PRL (lista de roaming) preferencial estiver disponível.
Para evitar operações frequentes de verificação de rede, o sistema operacional mantém uma lista de operações de verificação recentes e a lista de provedores é retornada da lista armazenada em cache.
Um aplicativo pode chamar esse método para obter uma lista de provedores visíveis após a conclusão do ScanNetwork.
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 |