Share via

IMbnInterface::GetVisibleProviders-Methode (mbnapi.h)

  • Artikel

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 ab.

Syntax

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

Parameter

[out, retval] age

Ein Zeiger auf die Zeit in Sekunden seit der letzten Aktualisierung der liste des sichtbaren Anbieters vom Gerät.

[out, retval] visibleProviders

Zeiger auf ein Array von MBN_PROVIDER Strukturen, das die Liste der Anbieter für die Schnittstelle enthält. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter NULL. Andernfalls muss das aufrufende Programm 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 auszurufen.
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 IMbnInterfaceEvents 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.

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 das Betriebssystem 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.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mbnapi.h

Weitere Informationen

IMbnInterface