Compartilhar via

Método IMbnInterface::GetVisibleProviders (mbnapi.h)

  • Artigo

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
S_OK
 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.
E_PENDING
 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.
E_MBN_INVALID_CACHE
 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

Confira também

IMbnInterface