Freigeben über

IMbnInterface::GetSubscriberInformation-Methode (mbnapi.h)

  • Artikel

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 Abonnenteninformationen ab.

Syntax

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

Parameter

[out, retval] subscriberInformation

Ein Zeiger auf die Adresse einer IMbnSubscriberInformation-Schnittstelle , die Abonnenteninformationen für das Gerät enthält. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter NULL.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen. subscriberInformation enthält eine gültige Schnittstelle.
E_PENDING
 Die Informationen sind nicht verfügbar. Der mobile Breitbanddienst sucht derzeit nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn die Informationen verfügbar sind, indem sie sich für die OnSubscriberInformationChange-Methode von IMbnInterfaceEvents registriert.

Hinweise

Die GetSubscriberInformation-Methode gibt die abonnentenbezogenen Informationen zurück, einschließlich Abonnenten-ID, internationaler SIM-Leitung Karte Nummer und Telefonnummern, die dieser Schnittstelle zugeordnet sind.

Wenn diese Methode von einer Windows Store-App mit Mobilfunkanbieterberechtigungen aufgerufen wird, gibt sie nur die sim International-Leitung Karte Durch die SimIccID-Eigenschaft definierte Nummer zurück.

Einige der in den Abonnenteninformationen zurückgegebenen Werte werden nur aufgefüllt, wenn der Bereit-Zustand, der von der GetReadyState-Methode von IMbnInterface gemeldet wird , MBN_READY_STATE_INITIALIZED ist. Bei jeder Änderung der Abonnenteninformationen im Zusammenhang mit dem Mobilen Breitbandgerät benachrichtigt der Mobile Broadband-Dienst registrierte Anwendungen, indem er die OnSubscriberInformationChange-Methode von IMbnInterfaceEvents aufruft.

Abonnenteninformationen für ein Gerät werden nicht geändert, sobald der Status "Gerätebereit " MBN_READY_STATE_INITIALIZED ist.

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

Weitere Informationen

IMbnInterface