IMbnInterface::GetReadyState-Methode (mbnapi.h)

  • Artikel

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 Status bereit ab.

Syntax

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

Parameter

[out, retval] readyState

Ein Zeiger auf eine MBN_READY_STATE-Struktur . Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter NULL.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen. readyState enthält gültige Werte.
E_PENDING
 Die Informationen sind nicht verfügbar. Der mobile Breitbanddienst sucht derzeit nach dem Status "Bereit". Die aufrufende Anwendung kann benachrichtigt werden, wenn der Status bereit verfügbar ist, indem sie sich für die OnReadyStateChange-Methode von IMbnInterfaceEvents registriert.

Hinweise

Der Status bereit gibt an, ob die Schnittstelle erfolgreich initialisiert wurde und zum Ausführen von Verbindungsvorgängen bereit ist. Für SIM-basierte Geräte ist ein Gerät bereit, wenn die SIM-Karte erfolgreich vom Gerät initialisiert wurde. Das Gerät kann nur für die Verbindung verwendet werden, wenn der Status "Bereit " MBN_READY_STATE_INITIALIZED ist. Weitere Informationen zu anderen Gerätezuständen finden Sie unter MBN_READY_STATE.

Der Bereit-Zustand einer Schnittstelle kann sich als Ergebnis eines Benutzervorgangs ändern. Wenn ein Benutzer beispielsweise eine SIM-Karte in ein Gerät einfügt, wechselt der Status Bereit von MBN_READY_STATE_SIM_NOT_INSERTED in einen anderen Bereit-Zustand. Der Status "Bereit" kann sich auch aufgrund anderer Vorgänge ändern, die von der Anwendung ausgeführt werden. Wenn beispielsweise eine PIN eingegeben wurde, kann sich der Status Bereit von MBN_READY_STATE_DEVICE_LOCKED in einen anderen Bereit-Zustand ändern. Eine Anwendung kann sich für Ereignisbenachrichtigungen registrieren, wenn sich der Status "Bereit" der Schnittstelle ändert. Das OnReadyStateChange-Element von IMbnInterfaceEvents wird aufgerufen, um eine Anwendung über jede Änderung im Status Bereit zu benachrichtigen.

Das SMS-Subsystem des Geräts ist möglicherweise nicht bereit, wenn es MBN_READY_STATE_INITIALIZED meldet. Eine aufrufende Anwendung sollte auf einen Aufruf des OnSmsConfigurationChange-Elements von IMbnSmsEvents warten, der angibt, dass das SMS-Subsystem bereit ist.

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

IMbnInterface