Partager via

Méthode IMbnInterfaceEvents::OnSetPreferredProvidersComplete (mbnapi.h)

  • Article

Important

À compter de Windows 10 version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.

Cette méthode de notification est appelée par le service Haut débit mobile pour indiquer l’achèvement d’une opération SetPreferredProviders .

Syntaxe

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

Paramètres

[in] newInterface

IMbnInterface qui représente un appareil sur lequel cette opération a été effectuée.

[in] requestID

ID de demande attribué par le service Haut débit mobile pour cette opération asynchrone.

[in] status

Status d’achèvement de l’opération.

Le tableau suivant répertorie les valeurs valides pour cette status.

Valeur Signification
S_OK
 L'opération a réussi.
E_MBN_PIN_REQUIRED
 L’appareil nécessite qu’un code confidentiel soit entré pour que cette opération se termine.
E_MBN_SIM_NOT_INSERTED
 La carte SIM n’est pas insérée.
E_MBN_BAD_SIM
 Une carte SIM incorrecte est insérée dans l’appareil.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 L’appareil ne prend pas en charge cette opération.

Valeur retournée

Cette méthode doit retourner S_OK.

Notes

Si l’opération s’est terminée correctement, c’est-à-dire lorsque status est S_OK, l’application peut appeler la méthode GetPreferredProviders de l’IMbnInterface passé pour obtenir une liste mise à jour des fournisseurs préférés.

Si plusieurs applications sont inscrites pour les notifications, cette méthode est appelée sur toutes les applications inscrites. Cela signifie qu’une application qui n’a pas lancé l’opération de mise à jour recevra également une notification.

Si un appel à la méthode SetPreferredProvidersd’IMbnInterface entraîne une modification de la liste des fournisseurs préférés, la méthode OnPreferredProvidersChanged’IMbnInterfaceEvents n’est pas appelée.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête mbnapi.h

Voir aussi

IMbnInterfaceEvents