IMbnMultiCarrierEvents::OnScanNetworkComplete-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.

Diese Benachrichtigungsmethode wird vom Mobile Broadband-Dienst aufgerufen, um den Abschluss eines ScanNetwork-Vorgangs anzugeben.

Syntax

HRESULT OnScanNetworkComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parameter

[in] mbnInterface

Ein IMbnMultiCarrier-Objekt , das den ScanNetwork-Vorgang des mobilen Breitbandgeräts darstellt.

[in] requestID

Die Anforderungs-ID, die vom Mobilen Breitbanddienst dem ScanNetwork-Vorgang zugewiesen wurde.

[in] status

Ein status Code, der das Ergebnis von ScanNetwork angibt.

Wert Bedeutung
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 ausstellen, wenn sie die funkgesteuerte Benachrichtigung erhält.
E_MBN_DEVICE_BUSY
 Das Gerät ist ausgelastet und kann derzeit keinen Netzwerkscanvorgang ausführen. Dies wird von Geräten zurückgegeben, die keinen Netzwerkscanvorgang unterstützen, wenn eine Datenverbindung hergestellt wurde.
E_MBN_ALREADY_ACTIVE
 Ein Netzwerkscanvorgang wird bereits ausgeführt.
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.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Wenn statusS_OK ist, hat der mobile Breitbanddienst die zwischengespeicherte Liste der sichtbaren Anbieter erfolgreich aktualisiert. Eine Anwendung kann dann die GetVisibleProviders-Methode des übergebenen IMbnMultiCarrier 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 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mbnapi.h

Weitere Informationen

IMbnMultiCarrierEvents