Méthode IMbnRegistration::GetProviderName (mbnapi.h)

Obtient le nom du fournisseur pour le réseau actuellement inscrit.

Syntaxe

HRESULT GetProviderName(
  [out] BSTR *providerName
);

Paramètres

[out] providerName

Pointeur vers une chaîne qui contient le nom du fournisseur actuellement inscrit. La longueur maximale de cette chaîne est MBN_PROVIDERNAME_LEN caractères. La chaîne est remplie uniquement lorsque la méthode retourne S_OK de réussite. En cas de réussite, l’application appelante doit libérer la mémoire allouée en appelant SysFreeString.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Le nom du fournisseur peut changer lorsque l’appareil haut débit mobile passe d’un réseau à un autre. Cela inclut chaque fois qu’il y a un changement de MBN_REGISTER_STATE_HOME à MBN_REGISTER_STATE_SEARCHING dans l’état d’inscription réseau. Cela se produit également lorsqu’il y a un changement dans le réseau inscrit, par exemple lorsqu’un réseau change son inscription d’un fournisseur à un autre. Après ces modifications, le service haut débit mobile appelle la méthode OnRegisterStateChanged’IMbnRegistrationEvents. Dans ce cas, l’application doit appeler GetProviderID.

Pour le E_MBN_PIN_REQUIRED d’erreur récupérable, le service haut débit mobile tente de récupérer ces informations à partir de l’appareil lorsque la condition d’erreur est terminée (lorsqu’un code confidentiel est entré). Ensuite, il appelle la méthode OnRegisterStateChange de IMbnRegistrationEvents.

Spécifications

Voir aussi

IMbnRegistration