Méthode IMbnMultiCarrier::GetPreferredProviders (mbnapi.h)
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.
Obtient la liste des fournisseurs abonnés visibles dans la zone actuelle pour un appareil multifacteur moins le fournisseur inscrit actuel.
Syntaxe
HRESULT GetPreferredProviders(
[out, retval] SAFEARRAY **preferredMulticarrierProviders
);
Paramètres
[out, retval] preferredMulticarrierProviders
Pointeur vers un tableau de structures MBN_PROVIDER2 qui contiennent la liste des fournisseurs préférés. Si cette méthode retourne une valeur autre que S_OK, preferredMultiCarrierProviders a la valeur NULL. Lorsque GetPreferredProviders retourne S_OK, l’application appelante doit libérer la mémoire allouée en appelant SafeArrayDestroy.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. preferredMultiCarrierProviders contient des valeurs valides . |
|
Les informations ne sont pas disponibles. Le service haut débit mobile est actuellement en train d’examiner la liste des fournisseurs préférés. L’application appelante peut être avertie lorsque les données sont disponibles en s’inscrivant à la méthode OnPreferredProvidersChanged’IMbnMultiCarrierEvents. |
|
L’appareil nécessite qu’un code confidentiel soit entré pour cette opération. |
|
La carte SIM n’est pas insérée. |
|
Une carte SIM incorrecte est insérée dans l’appareil. |
|
Impossible de lire à partir de la carte SIM ou de la mémoire de l’appareil. Par exemple, la carte SIM n’a pas d’informations de fournisseur préférées provisionnée. |
|
L’appareil ne prend pas en charge cette opération. Les appareils CDMA retournent toujours cette valeur. |
|
L’opération n’est pas prise en charge par l’appareil. Cela peut être retourné par des appareils qui ne prennent pas en charge multifacteur. |
Notes
GetPreferredProviders retourne la liste des fournisseurs stockés dans la liste des fournisseurs préférés de l’interface.
Pour les erreurs récupérables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED et E_MBN_BAD_SIM, le service haut débit mobile interroge à nouveau l’appareil pour obtenir la liste des fournisseurs lorsque la condition d’erreur est terminée. Par exemple, si l’appareil nécessite l’entrée d’un code confidentiel pour obtenir la liste des fournisseurs, GetPreferredProviders retourne E_MBN_PIN_REQUIRED. Lorsqu’une application entre un code confidentiel pour déverrouiller l’appareil, le service haut débit mobile tente à nouveau d’obtenir ces informations à partir de l’appareil.
Lorsque Windows interroge l’appareil pour obtenir la liste des fournisseurs après qu’une erreur récupérable s’est produite, GetPreferredProviders retourne immédiatement E_PENDING. Une fois la nouvelle requête terminée, une notification est envoyée à l’application appelante à l’aide de la méthode de rappel appropriée. Par exemple, après une opération de déverrouillage de code confidentiel réussie, la méthode OnEnterCompleted’IMbnPinEvents est appelée.
Le service Haut débit mobile met à jour l’application sur la status de toute nouvelle requête en appelant la méthode OnPreferredProvidersChanged’IMbnMultiCarrier.
Dans certains cas, la liste des fournisseurs préférés de l’appareil peut être mise à jour via le réseau par SMS ou OTA (mise à jour en direct). Windows avertit l’application de toute modification apportée à la liste des fournisseurs préférés en appelant la méthode OnPreferredProvidersChange de IMbnMultiCarrier.
Une liste de fournisseurs par défaut est disponible si l’utilisateur dispose de plusieurs abonnements (au moins plusieurs) ou si l’appareil a préconfigurée pour les réseaux préférés et se trouve dans la zone de couverture de l’un des réseaux. Cette liste peut être vide même si l’utilisateur s’est abonné à plusieurs réseaux et se trouve en dehors de ces zones de couverture. Cette liste contient tous les réseaux actuellement visibles auxquels l’utilisateur s’est abonné ou que l’appareil a préprovisionné, à l’exception du réseau actuellement inscrit.
L’approvisionnement peut également entraîner l’ajout d’un nouveau fournisseur d’accueil à la liste des préférences existante sur un appareil multifacteur. Pour ce faire, utilisez SetHomeProvider.
Spécifications
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |