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

Examina de forma assíncrona a rede para obter uma lista de provedores visíveis.

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 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.

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 IMbnInterface 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 a 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 IMbnInterfaceEvents para notificar a aplicação da conclusão da operação.

Se o dispositivo for removido do sistema antes da conclusão desta 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 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