Compartilhar via

Método IMbnInterfaceEvents::OnSetPreferredProvidersComplete (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 SetPreferredProviders .

Sintaxe

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parâmetros

[in] newInterface

Um IMbnInterface que representa um dispositivo no qual essa operação foi executada.

[in] requestID

A ID de solicitação atribuída pelo serviço de Banda Larga Móvel para essa operação assíncrona.

[in] status

O status de conclusão da operação.

A tabela a seguir lista os valores válidos para esse status.

Valor Significado
S_OK
 A operação foi bem-sucedida.
E_MBN_PIN_REQUIRED
 O dispositivo requer que um PIN seja inserido para que essa operação seja concluída.
E_MBN_SIM_NOT_INSERTED
 O SIM não está inserido.
E_MBN_BAD_SIM
 Um SIM incorreto é inserido no dispositivo.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 O dispositivo não dá suporte a essa operação.

Valor retornado

Esse método deve retornar S_OK.

Comentários

Se a operação for concluída com êxito, ou seja, quando status for S_OK, o aplicativo poderá chamar o método GetPreferredProviders do IMbnInterface passado para obter uma lista atualizada de provedores preferenciais.

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 também receberá uma notificação.

Se uma chamada para o método SetPreferredProviders de IMbnInterface resultar em uma alteração na lista de provedores preferenciais, o método OnPreferredProvidersChange de IMbnInterfaceEvents não será chamado.

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

IMbnInterfaceEvents