Méthode IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)
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 la fin d’une analyse réseau.
Syntaxe
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Paramètres
[in] newInterface
IMbnInterface qui représente un appareil sur lequel cette opération a été effectuée.
[in] requestID
ID de demande attribué par le service Haut débit mobile pour cette notification.
[in] status
Status d’achèvement de l’opération
Une application appelante peut s’attendre à l’une des valeurs suivantes.
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.
Valeur retournée
Cette méthode doit retourner S_OK.
Notes
Si l’opération s’est terminée avec succès, c’est-à-dire lorsque 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 de l’IMbnInterface 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.
Spécifications
| Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |