Méthode IMbnServiceActivationEvents ::OnActivationComplete (mbnapi.h)

Article
03/04/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 qu’une demande d’activation de service est terminée.

Syntaxe

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Paramètres

[in] serviceActivation

Pointeur vers une interface IMbnServiceActivation représentant l’appareil sur lequel la demande a été effectuée.

[in] vendorSpecificData

Tableau d’octets contenant les données retournées par le pilote miniport Mobile Broadband sous-jacent dans NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

ID de demande attribué par le service Haut débit mobile lors de l’initialisation de la demande.

[in] status

Status d’achèvement.

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

Valeur	Signification
S_OK	L'opération a réussi.
E_INVALIDARG	Le pilote miniport a détecté des données d’entrée incorrectes dans la requête.
E_MBN_PIN_REQUIRED	Un code confidentiel est nécessaire pour que l’opération se termine.
E_MBN_RADIO_POWER_OFF	L’appareil haut débit mobile n’est pas mis sous tension.
E_MBN_PROVIDER_NOT_VISIBLE	Le fournisseur de services n’est pas visible.
E_MBN_SIM_NOT_INSERTED	Il n’y a pas de carte SIM dans l’appareil.
E_MBN_BAD_SIM	Il y a une carte SIM incorrecte dans l’appareil.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’appareil ne prend pas en charge cette opération.

[in] networkError

Code d’erreur retourné par le réseau pendant l’opération d’activation. Cette valeur n’est significative que lorsque status n’est pas S_OK.

La valeur exacte de networkError est dépendante du pilote/du réseau.

Valeur retournée

Cette méthode doit retourner S_OK.

Remarques

L’activation du service réussie entraîne également une modification de l’état prêt de l’appareil. le service Haut débit mobile appelle la méthode OnReadyStateChange de IMbnInterfaceEvents en tant que notification.

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

IMbnServiceActivationEvents

Partager via