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

Article
08/24/2023

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 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.

Code de retour	Description
S_OK	L'opération a réussi.
E_PENDING	L’ID du fournisseur n’est pas disponible. Le service Haut débit mobile est en train de sonder l’appareil pour obtenir des informations. Lorsque l’ID du fournisseur est disponible, le service haut débit mobile appelle la méthode OnRegisterModeAvailable de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED	Un code confidentiel est requis pour obtenir l’ID du fournisseur.
MBN_SIM_NOT_INSERTED	Aucune carte SIM n’est insérée dans l’appareil.
E_MBN_BAD_SIM	Une carte SIM incorrecte est insérée dans l’appareil.

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


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

IMbnRegistration

Partager via