IMbnMultiCarrier::GetVisibleProviders-Methode (mbnapi.h)

Artikel
08/24/2023

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
S_OK	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.
E_PENDING	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.
E_MBN_INVALID_CACHE	Der Cache der sichtbaren Netzwerkliste von Mobile Broadband ist ungültig. Die aufrufende Anwendung sollte ScanNetwork aufrufen, um den Cache aufzufüllen.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	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

Weitere Informationen

IMbnMultiCarrier

Freigeben über