Partager via

Méthode IMbnInterface::GetHomeProvider (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.

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
S_OK
 La commande s'est correctement terminée. homeProvider contient des valeurs valides.
E_PENDING
 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.
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 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

Voir aussi

IMbnInterface