Método IMbnMultiCarrier::ScanNetwork (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.

Examina a rede para obter uma lista de provedores visíveis para um dispositivo de várias operadoras.

Sintaxe

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Parâmetros

[out] requestID

Ponteiro para a ID de solicitação definida pelo sistema operacional para essa solicitação. A resposta assíncrona de OnScanNetworkComplete conterá essa mesma requestID.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução neste sistema.
E_HANDLE	A interface é inválida. Provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A interface é inválida. Provavelmente porque o dispositivo de Banda Larga Móvel foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	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 inicia uma operação de verificação de rede. Quando concluído com êxito, ele preenche o cache do sistema operacional de provedores e aplicativos visíveis pode chamar o método GetVisibleProviders de IMbnMultiCarrier para obter uma lista de redes visíveis.

Essa é uma operação demorada. Portanto, os aplicativos devem primeiro chamar GetVisibleProviders e devem chamar ScanNetwork somente quando as informações armazenadas em cache forem antigas.

Essa é uma operação assíncrona e ScanNetwork retornará imediatamente. Se esse método retornar com êxito (com S_OK), após a conclusão da operação de verificação, o sistema operacional chamará o método OnScanNetworkComplete de IMbnMultiCarrierEvents para notificar o aplicativo de conclusão da operação.

Se o dispositivo for removido do sistema antes da conclusão dessa operação, não haverá garantia de que a notificação de conclusão será recebida pelo aplicativo.

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

Confira também

IMbnMultiCarrier