Méthode IMbnMultiCarrier ::ScanNetwork (mbnapi.h)

Analyse le réseau pour obtenir la liste des fournisseurs visibles d’un appareil multifacteur.

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 d’OnScanNetworkComplete contient ce même requestID.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

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 GetVisibleProviders de IMbnMultiCarrier 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 IMbnMultiCarrierEvents 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

Voir aussi

IMbnMultiCarrier