IMbnRegistration::GetAvailableDataClasses-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 verfügbaren Datenklassen im aktuellen Netzwerk ab.
Syntax
HRESULT GetAvailableDataClasses(
[out] ULONG *availableDataClasses
);
Parameter
[out] availableDataClasses
Ein Zeiger auf eine bitweise OR-Kombination aus MBN_DATA_CLASS Werten. 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. |
Hinweise
GetAvailableDataClasses gibt den Satz der Datenklasse zurück, die im aktuellen Netzwerk möglich ist. Diese Werte können auf MBN_DATA_CLASS_NONE festgelegt werden, wenn der Wert nicht bekannt ist.
Verfügbare Datenklassen können sich automatisch ändern, wenn ein Gerät von einer Zelle zu einer 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 |