Méthode IMbnConnectionContext::GetProvisionedContexts (mbnapi.h)

Obtient une liste de contextes de connexion.

Syntaxe

HRESULT GetProvisionedContexts(
  [out, retval] SAFEARRAY **provisionedContexts
);

Paramètres

[out, retval] provisionedContexts

Liste des valeurs MBN_CONTEXT qui représentent les contextes de connexion stockés dans l’appareil. En cas d’erreur, ce tableau a la valeur NULL. En cas de réussite, l’application appelante doit libérer la mémoire allouée en appelant SafeArrayDestroy.

Valeur retournée

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

Notes

Un contexte de connexion est une abstraction d’un ensemble spécifique de paramètres de configuration réseau pour la configuration d’un circuit virtuel ou d’un flux au-dessus de la connexion à haut débit mobile physique à la couche 2. Dans GSM, il correspond au concept d’un contexte PDP ; dans CDMA, il correspond à un profil réseau.

Dans certains cas, les paramètres de connexion sont déjà disponibles dans la mémoire de l’appareil/SIM. Cette méthode peut être utilisée pour obtenir la liste des contextes de connexion stockés dans l’appareil pour le réseau de fournisseur de services résidentiels actuel.

Seuls les contextes de type MBN_CONTEXT_TYPE_INTERNET doivent être utilisés pour établir des connexions de données.

Un appareil retourne tous les contextes stockés pour le fournisseur d’accueil actuel. Certains des contextes peuvent être vides et ils seront signalés comme MBN_CONTEXT_TYPE_NONE.

Parfois, les contextes provisionnés stockés peuvent être mis à jour par le réseau via SMS ou OTA. Chaque fois qu’il y a une modification dans les contextes provisionnés par l’appareil, le service haut débit mobile appelle la méthode OnProvisionedContextListChanged’IMbnConnectionContextEvents. Une application peut ensuite utiliser cette méthode pour obtenir la liste mise à jour des contextes provisionnés.

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 obtenir ces informations lorsque la condition d’erreur est terminée. Par exemple, si l’appareil a besoin d’un code confidentiel pour récupérer les contextes de connexion, il retourne E_MBN_PIN_REQUIRED. Lorsque l’application entre un code confidentiel pour déverrouiller l’appareil, le service tente à nouveau d’obtenir ces informations à partir de l’appareil. Le service met à jour l’application sur la status de la nouvelle requête en appelant la méthode OnProvisionedContextListChange de IMbnConnectionContextEvents.

Spécifications

Voir aussi

IMbnConnectionContext