Compartilhar via

Método IMbnMultiCarrierEvents::OnScanNetworkComplete (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.

Esse método de notificação é chamado pelo serviço de Banda Larga Móvel para indicar a conclusão de uma operação ScanNetwork .

Sintaxe

HRESULT OnScanNetworkComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parâmetros

[in] mbnInterface

Um objeto IMbnMultiCarrier que representa a operação ScanNetwork do dispositivo de banda larga móvel.

[in] requestID

A ID da solicitação atribuída pelo serviço de Banda Larga Móvel à operação ScanNetwork .

[in] status

Um código status que indica o resultado de ScanNetwork.

Valor Significado
S_OK
 A operação foi bem-sucedida.
E_MBN_RADIO_POWER_OFF
 Não é possível obter uma lista de rede visível porque o rádio do dispositivo está desativado. O aplicativo pode emitir uma solicitação de verificação de rede quando recebe a notificação ativada por rádio.
E_MBN_DEVICE_BUSY
 O dispositivo está ocupado e não pode executar uma operação de verificação de rede no momento. Isso é retornado por dispositivos que não dão suporte a uma operação de verificação de rede quando ela tem uma conexão de dados estabelecida.
E_MBN_ALREADY_ACTIVE
 Uma operação de verificação de rede já está em andamento.
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.

Valor retornado

Esse método deve retornar S_OK.

Comentários

Se status for S_OK, o serviço de Banda Larga Móvel atualizou com êxito a lista armazenada em cache de provedores visíveis. Um aplicativo pode chamar o método GetVisibleProviders do IMbnMultiCarrier passado para obter a lista de provedores visíveis.

Se vários aplicativos registrados para notificações, esse método será chamado em todos os aplicativos registrados. Isso significa que um aplicativo que não iniciou a operação de atualização receberá uma notificação.

Requisitos

   
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

IMbnMultiCarrierEvents