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

Article
03/01/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.

Obtient la liste des fournisseurs visibles dans la zone actuelle pour un appareil multifacteur moins les fournisseurs préférés et inscrits.

Syntaxe

HRESULT GetVisibleProviders(
  [out]         ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

Paramètres

[out] age

Pointeur vers l’heure, en secondes, depuis la dernière actualisation de la liste des fournisseurs visibles pour l’appareil.

[out, retval] visibleProviders

Pointeur vers un tableau de structures MBN_PROVIDER2 qui contient la liste des fournisseurs pour l’interface. Si cette méthode retourne une valeur autre que S_OK, visibleProviders a la valeur NULL. Lorsque GetVisibleProviders retourne S_OK, l’application appelante doit libérer la mémoire allouée en appelant SafeArrayDestroy.

Valeur retournée

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

Code de retour	Description
S_OK	La commande s'est correctement terminée. visibleProviders contient des valeurs valides. En fonction de l’ancienneté des informations, l’application appelante peut décider d’émettre un nouvel appel à ScanNetwork
E_PENDING	Les informations ne sont pas disponibles. Une analyse réseau active est en cours. L’application appelante peut être avertie quand les fonctionnalités de l’appareil sont disponibles en s’inscrivant à la méthode OnScanNetworkComplete de IMbnMultiCarrierEvents
E_MBN_INVALID_CACHE	Le cache haut débit mobile de la liste des réseaux visibles n’est pas valide. L’application appelante doit appeler ScanNetwork pour remplir le cache.
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.

Remarques

Cette méthode retourne la liste des fournisseurs actuellement visibles. Les appareils CDMA signalent uniquement leur fournisseur d’accueil si un réseau figurant dans leur liste d’itinérance préférée (PRL) est disponible.

Pour éviter les opérations d’analyse réseau fréquentes, Windows tient à jour une liste des opérations d’analyse récentes et la liste des fournisseurs est retournée à partir de la liste mise en cache.

Une application peut appeler cette méthode pour obtenir la liste des fournisseurs visibles à la fin de ScanNetwork.

Cette liste contient tous les réseaux actuellement visibles disponibles à l’emplacement de l’utilisateur, à l’exception de ceux signalés par le fournisseur inscrit actuel et de la liste des fournisseurs préférés. Cette liste contient des entrées réseau auxquelles les utilisateurs ne se sont pas abonnés. Cette liste indique à l’utilisateur un ensemble supplémentaire de choix réseau auxquels il peut potentiellement s’inscrire.

Configuration requise

Condition requise	Valeur
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

IMbnMultiCarrier

Partager via