IMbnInterfaceEvents::OnScanNetworkComplete-Methode (mbnapi.h)

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

Weitere Informationen

IMbnInterfaceEvents