Método IMbnMultiCarrier::GetVisibleProviders (mbnapi.h)
Importante
A partir de 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 na área atual para um dispositivo multi-operadora menos provedores preferenciais e registrados.
Sintaxe
HRESULT GetVisibleProviders(
[out] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
Parâmetros
[out] age
Um ponteiro para a hora, em segundos, desde a última atualização da lista de provedores visível para o dispositivo.
[out, retval] visibleProviders
Ponteiro para uma matriz de estruturas de MBN_PROVIDER2 que contém a lista de provedores para a interface. Se esse método retornar qualquer valor diferente de S_OK, visibleProviders será NULL. Quando GetVisibleProviders retorna S_OK, o aplicativo de chamada deve liberar a memória alocada chamando SafeArrayDestroy.
Retornar valor
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 IMbnMultiCarrierEvents |
|
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. |
|
A operação não é compatível com o dispositivo. Isso pode ser retornado por dispositivos que não dão suporte a várias operadoras. |
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 Windows 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.
Esta lista contém todas as redes visíveis no momento disponíveis no local do usuário, excluindo as relatadas pelo provedor registrado atual e a lista de provedores preferenciais. Esta lista contém entradas de rede às quais os usuários não se inscreveram. Essa lista provedora o usuário com um conjunto adicional de opções de rede para as quais ele pode se inscrever.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |