Méthode IMbnInterface::GetVisibleProviders (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.

Obtient la liste des fournisseurs visibles.

Syntaxe

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

Paramètres

[out, retval] age

Pointeur vers le délai en secondes depuis la dernière actualisation de la liste des fournisseurs visibles à partir de l’appareil.

[out, retval] visibleProviders

Pointeur vers un tableau de structures MBN_PROVIDER qui contient la liste des fournisseurs pour l’interface. Si cette méthode retourne une valeur autre que S_OK, ce paramètre a la valeur NULL. Sinon, une fois l’opération terminée, le programme appelant 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 IMbnInterfaceEvents.
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.

Notes

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, le système d’exploitation gère 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.

Configuration requise


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

Voir aussi

IMbnInterface

Partager via