Méthode IMbnInterface::GetHomeProvider (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 le fournisseur d’accueil.
Syntaxe
HRESULT GetHomeProvider(
[out, retval] MBN_PROVIDER *homeProvider
);
Paramètres
[out, retval] homeProvider
Pointeur vers une structure de MBN_PROVIDER qui représente le fournisseur d’accueil. Si cette méthode retourne une valeur autre que S_OK, ce paramètre a la valeur NULL. Une fois l’opération terminée, l’application appelante doit libérer la mémoire allouée aux membres providerID et providerName de MBN_PROVIDER en appelant SysFreeString
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. homeProvider contient des valeurs valides. |
|
Les informations ne sont pas disponibles. Le service haut débit mobile est actuellement en train de sonder le fournisseur d’accueil. L’application appelante peut être avertie quand le fournisseur d’accueil est disponible en s’inscrivant à la méthode OnHomeProviderAvailable de IMbnInterfaceEvents. |
|
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 sur le fournisseur d’accueil approvisionnées. |
Notes
GetHomeProvider retourne les informations du fournisseur d’accueil pour l’appareil. Le champ dataClass de la structure MBN_PROVIDER retournée doit être ignoré.
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 le fournisseur d’accueil lorsque la condition d’erreur est terminée. Par exemple, si l’appareil nécessite la saisie d’un code confidentiel pour récupérer ces informations, il retourne E_MBN_PIN_REQUIRED. Lorsque l’application entre dans le code confidentiel pour déverrouiller l’appareil, le service haut débit mobile tente à nouveau d’obtenir ces informations à partir de l’appareil. Le système met à jour l’application sur la status de la nouvelle requête en appelant la méthode OnHomeProviderAvailable de IMbnInterfaceEvents.
La méthode OnHomeProviderAvailable inscrite de IMbnInterfaceEvents peut être appelée lorsque les informations du fournisseur d’accueil sont disponibles ou lorsque la nouvelle requête est terminée avec une erreur. Une fois que cette fonction retourne la réussite, ces informations ne changent jamais.
Spécifications
| 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 |