IMbnRegistrationEvents::OnSetRegisterModeComplete-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 ein Festgelegter Registrierungsvorgang abgeschlossen wurde.

Syntax

HRESULT OnSetRegisterModeComplete(
  [in] IMbnRegistration *newInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parameter

[in] newInterface

Zeiger auf eine IMbnRegistration-Schnittstelle , die das entsprechende Gerät darstellt. Die behandelnde Anwendung kann diese Schnittstelle verwenden, um den aktuellen Registrierungsstatus des Geräts abzurufen.

[in] requestID

Die Anforderungs-ID, die vom Mobile Broadband-Dienst zum Nachverfolgen des Registrierungsvorgangs für den Set zugewiesen wurde.

[in] status

Ein status Code, der das Ergebnis des Vorgangs angibt.

Eine aufrufende Anwendung kann einen der möglichen Werte erwarten.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Es besteht bereits eine aktive Netzwerkverbindung. Der Registrierungsmodus kann nicht geändert werden, wenn eine bereits hergestellte Datenverbindung besteht. Die Anwendung sollte zuerst die Verbindung trennen und dann versuchen, den Registrierungsmodus zu ändern. Wenn sich das Gerät bereits im angeforderten Modus befindet und mit dem angeforderten Anbieter verbunden ist, wird der Rückgabecode S_OK.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Der Vorgang wird vom Gerät nicht unterstützt. Dies kann von Geräten zurückgegeben werden, die den angeforderten Registrierungsmodus nicht unterstützen. Beispielsweise gibt ein CDMA-Gerät diesen Fehler zurück, wenn es aufgefordert wird, in den manuellen Registrierungsmodus zu wechseln.
E_FAIL	Der Vorgang konnte nicht abgeschlossen werden. Weitere Informationen finden Sie im Netzwerkfehlercode.
E_INVALIDARG	Ungültige Registrierungsmoduseingaben oder die anbieter-ID, die als Eingabe angegeben wird, ist länger als die maximale Länge von 7 Zeichen, oder die angegebene Datenklasse ist ungültig. Der Mobile Broadband-Dienst sendet die Anforderung nicht an das Gerät, wenn ungültige Argumente in der Eingabe angegeben werden. Im manuellen Registrierungsmodus bedeutet dies, dass der angeforderte Anbieter verboten ist.
E_MBN_PIN_REQUIRED	Für den Abschluss des Vorgangs ist eine PIN erforderlich.
E_MBN_SERVICE_NOT_ACTIVATED	Das Netzwerkdienstabonnement ist abgelaufen.
E_MBN_PROVIDER_NOT_VISIBLE	Dies tritt nur auf, wenn Sie in den manuellen Registrierungsmodus wechseln. Der Wechsel ist erfolgreich, aber der angeforderte Anbieter ist nicht sichtbar. Das Gerät registriert sich beim angeforderten Anbieter, wenn es sichtbar ist.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnRegistrationEvents

Freigeben über