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

Obtient l’ID du fournisseur pour le réseau actuellement inscrit.

Syntaxe

HRESULT GetProviderID(
  [out] BSTR *providerID
);

Paramètres

[out] providerID

Pointeur vers une chaîne qui contient l’ID du fournisseur actuellement inscrit. La longueur maximale est MBN_PROVIDERID_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

La méthode GetProviderID obtient l’ID du fournisseur actuellement inscrit. Pour le mode de sélection automatique du réseau, il s’agit de l’ID du réseau auprès duquel l’appareil est actuellement inscrit. Si le mode de sélection du réseau est manuel, ce champ contient l’ID de fournisseur du réseau auquel l’appareil tentera de s’inscrire. Pour les appareils CDMA, il est défini sur MBN_CDMA_DEFAULT_PROVIDER_ID si l’ID du fournisseur n’est pas connu.

Ces informations peuvent 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 en cas de modification du réseau inscrit, par exemple lorsqu’un réseau déplace son inscription d’un fournisseur à un autre. Après ces modifications, le service Haut débit mobile appelle la méthode OnRegisterStateChange de IMbnRegistrationEvents. Dans ce cas, l’application doit appeler GetProviderID.

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

Spécifications

Voir aussi

IMbnRegistration