IMbnRegistration::GetProviderID-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 Anbieter-ID für das aktuell registrierte Netzwerk ab.
Syntax
HRESULT GetProviderID(
[out] BSTR *providerID
);
Parameter
[out] providerID
Zeiger auf eine Zeichenfolge, die die ID des derzeit registrierten Anbieters enthält. Die maximale Länge beträgt MBN_PROVIDERID_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. |
|
Die Anbieter-ID ist nicht verfügbar. Der mobile Breitbanddienst durchscheckt derzeit das Gerät nach den Informationen. Wenn die Anbieter-ID verfügbar ist, ruft der mobile Breitbanddienst die OnRegisterModeAvailable-Methode von IMbnRegistrationEvents auf. |
|
Zum Abrufen der Anbieter-ID 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 GetProviderID-Methode ruft die ID des derzeit registrierten Anbieters ab. Für den automatischen Netzwerkauswahlmodus ist dies die ID des Netzwerks, bei dem das Gerät derzeit registriert ist. Wenn der Netzwerkauswahlmodus manuell ist, enthält dieses Feld die Anbieter-ID des Netzwerks, bei dem das Gerät versucht, sich zu registrieren. Für CDMA-Geräte wird auf MBN_CDMA_DEFAULT_PROVIDER_ID festgelegt, wenn die Anbieter-ID nicht bekannt 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 zu einem anderen verschiebt. 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 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
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |