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

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

Freigeben über