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

Atualizações a lista de provedores preferenciais para o dispositivo.

Sintaxe

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

Parâmetros

[in] preferredProviders

Uma matriz de estruturas de MBN_PROVIDER que contém a lista de provedores preferenciais.

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

Valor retornado

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

O método SetPreferredProviders inicia uma atualização da lista de provedores preferenciais para a interface. Essa é uma operação assíncrona e a chamada de método retorna imediatamente. Se esse método retornar com êxito (com S_OK), o sistema operacional notificará o aplicativo de chamada sobre o status de conclusão dessa operação chamando o método OnSetPreferredProvidersComplete de IMbnInterfaceEvents.

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

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

IMbnInterface