IMbnRegistration::GetRoamingText-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 den Roamingtext ab, der den Roaminganbieter beschreibt.
Syntax
HRESULT GetRoamingText(
[out] BSTR *roamingText
);
Parameter
[out] roamingText
Zeiger auf eine Zeichenfolge, die zusätzliche Informationen zu einem Netzwerk enthält, mit dem das Gerät roamingt. Die maximale Länge beträgt MBN_ROAMTEXT_LEN Zeichen. Die Zeichenfolge wird nur ausgefüllt, wenn die Methode S_OK für den Erfolg zurückgibt. Bei Erfolg muss die aufrufende Anwendung den zugewiesenen Arbeitsspeicher durch Aufrufen von SysFreeString freigeben.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Roamingtext ist nicht verfügbar. Der mobile Breitbanddienst sucht derzeit das Gerät nach den Informationen. Wenn der Roamingtext verfügbar ist, ruft der Mobile Broadband-Dienst die OnRegisterModeAvailable-Methode von IMbnRegistrationEvents auf. |
|
Zum Abrufen des Roamingtexts 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 GetRoamingText-Methode kann eine Textzeichenfolge abrufen, die zusätzliche Informationen zum Netzwerk enthält, wenn der Registrierungsstatus entweder MBN_REGISTER_STATE_PARTNER oder MBN_REGISTER_STATE_ROAMING ist.
Diese Informationen können sich ändern, wenn das mobile Breitbandgerät von einem Netzwerk in ein anderes wechselt. Dies schließt ein, wenn eine Änderung von MBN_REGISTER_STATE_HOME zu MBN_REGISTER_STATE_SEARCHING im Netzwerkregistrierungsstatus erfolgt. Dies tritt auch auf, wenn es eine Änderung im registrierten Netzwerk gibt, z. B. wenn ein Netzwerk seine Registrierung von einem Anbieter auf einen anderen verschiebt. Nach solchen Änderungen ruft der Mobile Broadband-Dienst die OnRegisterStateChange-Methode von IMbnRegistrationEvents auf.
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 |