Méthode IMbnInterface ::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 préférés.

Syntaxe

HRESULT GetPreferredProviders(
  [out, retval] SAFEARRAY **preferredProviders
);

Paramètres

[out, retval] preferredProviders

Pointeur vers un tableau de structures MBN_PROVIDER qui contient la liste des fournisseurs préférés. Si cette méthode retourne une valeur autre que S_OK, ce paramètre 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
S_OK	La commande s'est correctement terminée. preferredProviders contient des valeurs valides .
E_PENDING	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’IMbnInterfaceEvents.
E_MBN_PIN_REQUIRED	L’appareil nécessite qu’un code confidentiel soit entré pour cette opération.
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_READ_FAULT)	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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’appareil ne prend pas en charge cette opération. Les appareils CDMA retournent toujours cette valeur.

Remarques

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 le système d’exploitation 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. Après la récupération à partir d’une erreur d’carte SIM, la méthode OnReadyStateChanged’IMbnInterfaceEvents 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’IMbnInterfaceEvents.

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). Le système d’exploitation notifiera l’application de toute modification dans la liste des fournisseurs préférés en appelant la méthode OnPreferredProvidersChanged’IMbnInterfaceEvents.

Configuration requise

Condition requise	Valeur
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

IMbnInterface