Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Ruft den Registrierungsstatus ab.
Syntax
HRESULT GetRegisterState(
[out] MBN_REGISTER_STATE *registerState
);
Parameter
[out] registerState
Ein Zeiger für einen MBN_REGISTER_STATE Wert, der den aktuellen Registrierungsstatus des Geräts angibt. Der Wert ist nur dann sinnvoll, wenn die Methode S_OK zurückgegeben hat.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Registrierungsstatus ist nicht verfügbar. Der mobile Breitbanddienst sucht derzeit das Gerät nach den Informationen. Wenn der Registrierungsstatus verfügbar ist, ruft der Mobile Broadband-Dienst die OnRegisterStateChange-Methode von IMbnRegistrationEvents auf. |
|
Zum Abrufen des Registrierungsstatus ist eine PIN erforderlich. |
Hinweise
Die GetRegisterState-Methode ruft den aktuellen Netzwerkregistrierungsstatus des Geräts ab. Das Gerät kann in einem Netzwerk registriert werden, das Netzwerk nach Registrierung durchsuchen oder die Registrierung verweigert werden.
Der Registrierungsstatus des Geräts kann sich automatisch ändern. Wenn das Gerät beispielsweise aus dem Netzwerkabdeckungsbereich ausgeht, ändert es den Registrierungsstatus von MBN_REGISTER_STATE_HOME in MBN_REGISTER_STATE_SEARCHING.
Eine Anwendung kann sich für den Empfang von Aktualisierungen zum Registrierungsstatus registrieren, indem sie eine Verbindung mit der IMbnRegistrationEvents-Schnittstelle herstellt. Windows ruft die OnRegisterStateChange-Methode von IMbnRegistrationEvents auf, um die Anwendung über diese Änderungen zu benachrichtigen.
Für den wiederherstellbaren Fehler E_MBN_PIN_REQUIRED versucht der Mobile Broadband-Dienst erneut, diese Informationen vom Gerät abzurufen, wenn die Fehlerbedingung abgelaufen ist (wenn eine PIN eingegeben wird). Anschließend wird die OnRegisterStateChange-Methode von IMbnRegistrationEvents aufgerufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |