IMbnServiceActivationEvents::OnActivationComplete-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.

Benachrichtigungsmethode, die vom Mobilen Breitbanddienst aufgerufen wird, um anzugeben, dass eine Dienstaktivierungsanforderung abgeschlossen wurde.

Syntax

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Parameter

[in] serviceActivation

Zeiger auf eine IMbnServiceActivation-Schnittstelle , die das Gerät darstellt, auf dem die Anforderung ausgeführt wurde.

[in] vendorSpecificData

Ein Bytearray mit den Daten, die vom zugrunde liegenden Mobile Broadband-Miniporttreiber in NDIS_STATUS_WWAN_SERVICE_ACTIVATION zurückgegeben werden.

[in] requestID

Die Anforderungs-ID, die vom Mobilen Breitbanddienst bei der Initialisierung der Anforderung zugewiesen wurde.

[in] status

Der Abschluss status.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
E_INVALIDARG	Der Miniporttreiber hat falsche Eingabedaten in der Anforderung erkannt.
E_MBN_PIN_REQUIRED	Eine PIN ist erforderlich, damit der Vorgang abgeschlossen werden kann.
E_MBN_RADIO_POWER_OFF	Das mobile Breitbandgerät wird nicht eingeschaltet.
E_MBN_PROVIDER_NOT_VISIBLE	Der Dienstanbieter ist nicht sichtbar.
E_MBN_SIM_NOT_INSERTED	Es ist keine SIM-Karte im Gerät vorhanden.
E_MBN_BAD_SIM	Auf dem Gerät ist eine schlechte SIM-Karte vorhanden.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Dieser Vorgang wird vom Gerät nicht unterstützt.

[in] networkError

Der Fehlercode, der vom Netzwerk während des Aktivierungsvorgangs zurückgegeben wird. Dieser Wert ist nur dann sinnvoll, wenn status nicht S_OK ist.

Der genaue Wert von networkError ist treiber-/netzwerkabhängig.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Eine erfolgreiche Aktivierung des Diensts führt auch zu einer Änderung des Bereitschaftszustands des Geräts. Der Mobile Broadband-Dienst ruft die OnReadyStateChange-Methode von IMbnInterfaceEvents als Benachrichtigung auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnServiceActivationEvents

Freigeben über