Méthode IMbnConnectionContextEvents ::OnSetProvisionedContextComplete (mbnapi.h)

Article
02/28/2024

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.

Méthode de notification appelée par le service Haut débit mobile pour indiquer que le contexte provisionné dans l’appareil a été défini.

Syntaxe

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

Paramètres

[in] newInterface

Interface IMbnConnectionContext qui représente l’appareil pour lequel le contexte a été défini.

[in] requestID

ID de requête défini par le service Haut débit mobile pour identifier l’opération qui définit le contexte.

[in] status

Un code status qui indique le résultat de l’opération.

Une application appelante peut s’attendre à l’une des valeurs suivantes.

Valeur	Signification
S_OK	L'opération a réussi.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’appareil ne prend pas en charge cette opération.
E_MBN_PIN_REQUIRED	Un code confidentiel est requis pour que l’opération se termine.
E_INVALIDARG	L’ID de contexte ou l’ID de fournisseur donné dans la demande n’est pas valide.
E_MBN_BAD_SIM	Il y a une carte SIM incorrecte dans l’appareil.
HRESULT_FROM_WIN32(ERROR_WRITE_FAULT)	Une mise à jour dans la mémoire SIM ou de l’appareil a échoué.

Valeur retournée

Cette méthode doit retourner S_OK.

Remarques

Une application appelante peut passer une interface IMbnConnectionContext à newInterface pour obtenir la liste mise à jour des contextes provisionnés dans l’appareil. Toutefois, étant donné que cette opération est asynchrone, l’application doit attendre la notification OnProvisionedContextListChange avant d’utiliser cette interface pour obtenir les contextes.

Si plusieurs applications sont inscrites pour recevoir des notifications, toutes recevront cette notification, même si une seule d’entre elles aurait pu lancer cette opération.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mbnapi.h

Voir aussi

IMbnConnectionContextEvents

Partager via