IMbnInterface::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 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 |
|---|---|
|
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. |
|
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. |
|
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 |