IMbnMultiCarrier::GetVisibleProviders-Methode (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Ruft die Liste der sichtbaren Anbieter im aktuellen Bereich für ein Gerät mit mehreren Trägern ab, abzüglich bevorzugter und registrierter Anbieter.
Syntax
HRESULT GetVisibleProviders(
[out] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
Parameter
[out] age
Ein Zeiger auf die Zeit in Sekunden seit der letzten Aktualisierung der Liste der sichtbaren Anbieter für das Gerät.
[out, retval] visibleProviders
Zeiger auf ein Array von MBN_PROVIDER2 Strukturen, das die Liste der Anbieter für die Schnittstelle enthält. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist visibleProvidersNULL. Wenn GetVisibleProvidersS_OK zurückgibt, muss die aufrufende Anwendung den zugewiesenen Arbeitsspeicher durch Aufrufen von SafeArrayDestroy freigeben.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. visibleProviders enthält gültige Werte. Basierend auf dem Alter der Informationen kann die aufrufende Anwendung entscheiden, einen neuen Aufruf von ScanNetwork ausstellen. |
|
Die Informationen sind nicht verfügbar. Es wird eine aktive Netzwerküberprüfung ausgeführt. Die aufrufende Anwendung kann benachrichtigt werden, wenn die Gerätefunktionen verfügbar sind, indem sie sich für die OnScanNetworkComplete-Methode von IMbnMultiCarrierEvents registriert. |
|
Der Cache der sichtbaren Netzwerkliste von Mobile Broadband ist ungültig. Die aufrufende Anwendung sollte ScanNetwork aufrufen, um den Cache aufzufüllen. |
|
Der Vorgang wird vom Gerät nicht unterstützt. Dies kann von Geräten zurückgegeben werden, die multi-Carrier nicht unterstützen. |
Hinweise
Diese Methode gibt die Liste der derzeit sichtbaren Anbieter zurück. CDMA-Geräte melden nur ihren Heimanbieter, wenn ein Netzwerk in ihrer bevorzugten Roamingliste (PRL) verfügbar ist.
Um häufige Netzwerkscanvorgänge zu vermeiden, verwaltet Windows eine Liste der letzten Scanvorgänge, und die Anbieterliste wird aus der zwischengespeicherten Liste zurückgegeben.
Eine Anwendung kann diese Methode aufrufen, um nach Abschluss von ScanNetwork eine Liste der sichtbaren Anbieter abzurufen.
Diese Liste enthält alle derzeit sichtbaren Netzwerke, die am Standort des Benutzers verfügbar sind, mit Ausnahme der vom aktuellen registrierten Anbieter gemeldeten Netzwerke und die Liste der bevorzugten Anbieter. Diese Liste enthält Netzwerkeinträge, die benutzer nicht abonniert haben. Diese Liste bietet dem Benutzer zusätzliche Netzwerkoptionen, für die er sich möglicherweise registrieren kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |