IMbnInterface ::GetSubscriberInformation, méthode (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 les informations de l’abonné.
Syntaxe
HRESULT GetSubscriberInformation(
[out, retval] IMbnSubscriberInformation **subscriberInformation
);
Paramètres
[out, retval] subscriberInformation
Pointeur vers l’adresse d’une interface IMbnSubscriberInformation qui contient des informations sur l’abonné pour l’appareil. Si cette méthode retourne une valeur autre que S_OK, ce paramètre a la valeur NULL.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. subscriberInformation contient une interface valide. |
|
Les informations ne sont pas disponibles. Le service haut débit mobile est en train de rechercher des informations. L’application appelante peut être avertie quand les informations sont disponibles en s’inscrivant à la méthode OnSubscriberInformationChange de IMbnInterfaceEvents. |
Remarques
La méthode GetSubscriberInformation renvoie les informations relatives à l’abonné, notamment l’ID d’abonné, le numéro de carte du circuit international SIM et les numéros de téléphone associés à cette interface.
Lorsque cette méthode est appelée à partir d’une application du Windows Store avec des privilèges d’opérateur mobile, elle retourne uniquement le circuit SIM International carte nombre défini par la propriété SimIccID.
Certaines des valeurs retournées dans les informations d’abonné sont renseignées uniquement lorsque l’état prêt signalé par la méthode GetReadyState de IMbnInterface est MBN_READY_STATE_INITIALIZED. Chaque fois qu’une modification est apportée aux informations d’abonné associées à l’appareil haut débit mobile, le service Haut débit mobile notifie les applications inscrites en appelant la méthode OnSubscriberInformationChange de IMbnInterfaceEvents.
Les informations d’abonné d’un appareil ne changent pas une fois que l’état prêt de l’appareil est MBN_READY_STATE_INITIALIZED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |