Compartilhar via


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

Esse método de notificação é chamado pelo serviço de Banda Larga Móvel para indicar uma alteração na lista de provedores preferenciais de um dispositivo.

Sintaxe

HRESULT OnPreferredProvidersChange(
  [in] IMbnInterface *newInterface
);

Parâmetros

[in] newInterface

Um IMbnInterface que representa o dispositivo de Banda Larga Móvel cuja lista de provedores preferenciais foi alterada.

Retornar valor

Esse método deve retornar S_OK.

Comentários

Em alguns casos, a lista de provedores preferenciais de um dispositivo pode ser atualizada pela rede por SMS ou atualização OTA (via ar). O serviço de Banda Larga Móvel chamará esse método para notificar o aplicativo sobre qualquer alteração na lista de provedores preferenciais. O aplicativo pode chamar o método GetPreferredProviders do IMbnInterface passado para obter a lista atualizada de provedores preferenciais.

Se houver uma alteração na lista de provedores preferenciais devido a uma chamada para o método SetPreferredProviders de IMbnInterface, essa notificação não será chamada.

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

IMbnInterfaceEvents