IMbnInterfaceEvents::OnScanNetworkComplete-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.
Diese Benachrichtigungsmethode wird vom Mobilen Breitbanddienst aufgerufen, um den Abschluss einer Netzwerküberprüfung anzugeben.
Syntax
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parameter
[in] newInterface
Eine IMbnInterface , die ein Gerät darstellt, auf dem dieser Vorgang ausgeführt wurde.
[in] requestID
Die Anforderungs-ID, die vom Mobilen Breitbanddienst für diese Benachrichtigung zugewiesen wird.
[in] status
Der vorgangsabschluss status
Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.
S_OK
Der Vorgang wurde durchgeführt.
E_MBN_RADIO_POWER_OFF
Eine sichtbare Netzwerkliste kann nicht abgerufen werden, da das Geräteradio ausgeschaltet ist. Die Anwendung kann eine Netzwerküberprüfungsanforderung ausgeben, wenn sie die Benachrichtigung über das Aktivierte Funkgerät erhält.
E_MBN_DEVICE_BUSY
Das Gerät ist ausgelastet und kann derzeit keinen Netzwerkscan durchführen. Dies wird von Geräten zurückgegeben, die einen Netzwerkscanvorgang nicht unterstützen, wenn eine Datenverbindung hergestellt wurde.
E_MBN_ALREADY_ACTIVE
Ein Netzwerkscanvorgang wird bereits ausgeführt.
Rückgabewert
Diese Methode muss S_OK zurückgeben.
Hinweise
Wenn der Vorgang erfolgreich abgeschlossen wurde, d. h. wenn status S_OK ist, hat der Mobile Broadband-Dienst die zwischengespeicherte Liste der sichtbaren Anbieter erfolgreich aktualisiert. Eine Anwendung kann dann die GetVisibleProviders-Methode des übergebenen IMbnInterface aufrufen, um die Liste der sichtbaren Anbieter abzurufen.
Wenn mehrere Anwendungen für Benachrichtigungen registriert sind, wird diese Methode für alle registrierten Anwendungen aufgerufen. Dies bedeutet, dass eine Anwendung, die den Updatevorgang nicht initiiert hat, eine Benachrichtigung erhält.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |