IMbnRegistration::GetProviderName-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 Anbieternamen für das aktuell registrierte Netzwerk ab.
Syntax
HRESULT GetProviderName(
[out] BSTR *providerName
);
Parameter
[out] providerName
Zeiger auf eine Zeichenfolge, die den Namen des derzeit registrierten Anbieters enthält. Die maximale Länge dieser Zeichenfolge beträgt MBN_PROVIDERNAME_LEN Zeichen. Die Zeichenfolge wird nur ausgefüllt, wenn die Methode S_OK für den Erfolg zurückgibt. Bei erfolgreicher Ausführung muss die aufrufende Anwendung den zugeordneten 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 Anbietername ist nicht verfügbar. Der mobile Breitbanddienst durchscheckt derzeit das Gerät nach den Informationen. Wenn der Anbietername verfügbar ist, ruft der mobile Breitbanddienst die OnRegisterModeAvailable-Methode von IMbnRegistrationEvents auf. |
|
Zum Abrufen des Anbieternamens 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
Der Anbietername kann sich ändern, wenn das mobile Breitbandgerät von einem Netzwerk in ein anderes wechselt. Dies gilt auch bei jeder Änderung von MBN_REGISTER_STATE_HOME zu MBN_REGISTER_STATE_SEARCHING im Netzwerkregistrierungsstatus. Dies tritt auch auf, wenn eine Änderung im registrierten Netzwerk erfolgt, z. B. wenn ein Netzwerk seine Registrierung von einem Anbieter zu einem anderen ändert. Nach diesen Änderungen ruft der mobile Breitbanddienst die OnRegisterStateChange-Methode von IMbnRegistrationEvents auf. In diesem Fall sollte die Anwendung GetProviderID aufrufen.
Für den behebbaren Fehler E_MBN_PIN_REQUIRED versucht der Mobile Broadband-Dienst, diese Informationen vom Gerät zurückzugeben, 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 |