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

Ajoute ou met à jour un contexte provisionné.

Syntaxe

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

Paramètres

[in] provisionedContexts

Structure MBN_CONTEXT qui spécifie le contexte provisionné à stocker dans l’appareil ou la carte SIM.

[in] providerID

Chaîne qui représente l’ID du fournisseur réseau pour lequel le contexte provisionné doit être stocké. L’appareil doit retourner le contexte provisionné ajouté en réponse à toute requête ultérieure lorsqu’une carte SIM avec cet ID de fournisseur d’accueil se trouve sur l’appareil.

[out] requestID

ID de demande défini par le service Haut débit mobile pour identifier cette demande asynchrone.

Valeur retournée

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

Remarques

Le contextID de provisionedContexts spécifie l’index dans la mémoire de l’appareil ou de la carte SIM où le contexte doit être stocké. S’il est défini sur MBN_CONTEXT_ID_APPEND, l’appareil doit trouver l’index approprié pour stocker le contexte.

Il s’agit d’une opération asynchrone et SetProvisionedContext retourne immédiatement. Une fois l’opération terminée, le service Haut débit mobile notifie l’application en appelant la méthode OnSetProvisionedContextComplete de IMbnConnectionContextEvents.

Les ajouts à la liste de contexte provisionné pour l’ID de fournisseur d’accueil actuel ne seront pas disponibles pour l’interrogation tant que la méthode OnProvisionedContextListChange de IMbnConnectionContextEvents n’aura pas été appelée.

Configuration requise

Voir aussi

IMbnConnectionContext