Méthode IMbnMultiCarrierEvents::OnScanNetworkComplete (mbnapi.h)

Article
08/24/2023

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.

Cette méthode de notification est appelée par le service Haut débit mobile pour indiquer l’achèvement d’une opération ScanNetwork .

Syntaxe

HRESULT OnScanNetworkComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Paramètres

[in] mbnInterface

Objet IMbnMultiCarrier qui représente l’opération ScanNetwork de l’appareil haut débit mobile.

[in] requestID

ID de demande attribué par le service Haut débit mobile à l’opération ScanNetwork .

[in] status

Un code status qui indique le résultat de ScanNetwork.

Valeur	Signification
S_OK	L'opération a réussi.
E_MBN_RADIO_POWER_OFF	Impossible d’obtenir une liste réseau visible, car la radio de l’appareil est désactivée. L’application peut émettre une demande d’analyse réseau lorsqu’elle reçoit la notification activée par radio.
E_MBN_DEVICE_BUSY	L’appareil est occupé et ne peut actuellement pas effectuer d’opération d’analyse réseau. Cela est retourné par les appareils qui ne prennent pas en charge une opération d’analyse réseau lorsqu’une connexion de données est établie.
E_MBN_ALREADY_ACTIVE	Une opération d’analyse réseau est déjà en cours.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’opération n’est pas prise en charge par l’appareil. Cela peut être retourné par des appareils qui ne prennent pas en charge multifacteur.

Valeur retournée

Cette méthode doit retourner S_OK.

Notes

Si status est S_OK, le service Haut débit mobile a correctement mis à jour la liste mise en cache des fournisseurs visibles. Une application peut ensuite appeler la méthode GetVisibleProviders du IMbnMultiCarrier passé pour obtenir la liste des fournisseurs visibles.

Si plusieurs applications sont inscrites pour les notifications, cette méthode est appelée sur toutes les applications inscrites. Cela signifie qu’une application qui n’a pas lancé l’opération de mise à jour reçoit une notification.

Configuration requise


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

Voir aussi

IMbnMultiCarrierEvents

Partager via