Méthode IMbnInterface ::ScanNetwork (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.
Analyse de façon asynchrone le réseau pour obtenir une liste des fournisseurs visibles.
Syntaxe
HRESULT ScanNetwork(
[out] ULONG *requestID
);
Paramètres
[out] requestID
Pointeur vers l’ID de demande défini par le système d’exploitation pour cette requête. La réponse asynchrone contient ce même requestID.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Le service haut débit mobile n’est pas en cours d’exécution sur ce système. |
|
L’interface n’est pas valide. Probablement parce que l’appareil haut débit mobile a été supprimé du système. |
|
L’interface n’est pas valide. Probablement parce que l’appareil haut débit mobile a été supprimé du système. |
Remarques
Cette méthode lance une opération d’analyse réseau. Une fois terminé, il remplit le cache du système d’exploitation des fournisseurs visibles et les applications peuvent appeler la méthode GetVisibleProvidersd’IMbnInterface pour obtenir la liste des réseaux visibles.
Cette opération prend du temps. Par conséquent, les applications doivent d’abord appeler GetVisibleProviders et ne doivent appeler ScanNetwork que lorsque les informations mises en cache sont anciennes.
Il s’agit d’une opération asynchrone et ScanNetwork retourne immédiatement. Si cette méthode retourne correctement (avec S_OK), le système d’exploitation appelle la méthode OnScanNetworkComplete de IMbnInterfaceEvents pour notifier l’application de la fin de l’opération.
Si l’appareil est supprimé du système avant la fin de cette opération, il n’y a aucune garantie que la notification d’achèvement sera reçue par l’application.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |