IMbnRegistration::GetCurrentDataClass-Methode (mbnapi.h)
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 die aktuelle Datenklasse im aktuellen Netzwerk ab.
Syntax
HRESULT GetCurrentDataClass(
[out] ULONG *currentDataClass
);
Parameter
[out] currentDataClass
Ein Zeiger auf einen MBN_DATA_CLASS-Wert . Dieser Parameter ist nur sinnvoll, wenn die Funktion S_OK zurückgibt.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Datenklassen sind nicht verfügbar. Der mobile Breitbanddienst durchscheckt derzeit das Gerät nach den Informationen. Wenn die Datenklassen verfügbar sind, ruft der Mobile Broadband-Dienst die OnPacketServiceStateChange-Methode von IMbnRegistrationEvents auf. |
|
Zum Abrufen der Datenklassen ist eine PIN erforderlich. |
|
Eine SIM-Karte ist nicht in das Gerät eingefügt. |
|
Eine ungültige SIM-Karte wird in das Gerät eingefügt. |
Hinweise
Die GetCurrentDataClass-Methode gibt die Datenklasse im aktuellen Netzwerk zurück. Dieser Wert kann auf MBN_DATA_CLASS_NONE festgelegt werden, wenn der Wert nicht bekannt ist.
Die aktuelle Datenklasse kann sich automatisch ändern, wenn ein Gerät von einem Mobilfunknetz zu einem anderen wechselt. Wenn eine solche Änderung auftritt, benachrichtigt der Mobile Broadband-Dienst Anwendungen, indem er die OnPacketServiceStateChange-Methode von IMbnRegistrationEvents aufruft.
Für den behebbaren Fehler E_MBN_PIN_REQUIRED versucht der mobile Breitbanddienst erneut, diese Informationen vom Gerät abzurufen, wenn die Fehlerbedingung abgelaufen ist (wenn eine PIN eingegeben wird). Anschließend ruft der mobile Breitbanddienst die OnPacketServiceStateChange-Methode von IMbnRegistrationEvents auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |