IMbnInterface::GetSubscriberInformation-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 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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. subscriberInformation enthält eine gültige Schnittstelle. |
|
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 |