IMbnConnectionContext::GetProvisionedContexts-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 eine Liste der Verbindungskontexte ab.

Syntax

HRESULT GetProvisionedContexts(
  [out, retval] SAFEARRAY **provisionedContexts
);

Parameter

[out, retval] provisionedContexts

Eine Liste von MBN_CONTEXT Werten, die auf dem Gerät gespeicherte Verbindungskontexte darstellen. Bei Einem Fehler ist dieses Array NULL. Bei erfolgreicher Ausführung muss die aufrufende Anwendung den zugewiesenen Arbeitsspeicher durch Aufrufen von SafeArrayDestroy freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_PENDING	Die Verbindungskontexte sind nicht verfügbar. Der mobile Breitbanddienst testiert das Gerät nach den Informationen. Die aufrufende Anwendung kann benachrichtigt werden, wenn die Verbindungskontexte verfügbar sind, indem sie sich für die OnProvisionedContextListChange-Methode von IMbnConnectionContextEvents registriert.
E_MBN_PIN_REQUIRED	Zum Abrufen der Verbindungskontexte ist eine PIN erforderlich.
E_MBN_SIM_NOT_INSERTED	Eine SIM-Karte ist nicht in das Gerät eingefügt.
E_MBN_BAD_SIM	Eine ungültige SIM-Karte wird in das Gerät eingefügt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Das Gerät unterstützt den Abruf bereitgestellter Kontexte nicht.

Hinweise

Ein Verbindungskontext ist eine Abstraktion eines bestimmten Satz von Netzwerkkonfigurationsparametern zum Einrichten einer virtuellen Verbindung oder eines Flusses auf der physischen mobilen Breitbandverbindung auf Ebene 2. In GSM entspricht es dem Konzept eines PDP-Kontexts; in CDMA entspricht es einem Netzwerkprofil.

In einigen Fällen sind Verbindungsparameter bereits im Geräte-/SIM-Speicher verfügbar. Diese Methode kann verwendet werden, um eine Liste der gespeicherten Verbindungskontexte abzurufen, die auf dem Gerät für das aktuelle Heimanbieternetzwerk gespeichert sind.

Zum Herstellen von Datenverbindungen sollten nur Kontexte vom Typ MBN_CONTEXT_TYPE_INTERNET verwendet werden.

Ein Gerät gibt alle gespeicherten Kontexte für den aktuellen Heimanbieter zurück. Einige der Kontexte können leer sein, und sie werden als MBN_CONTEXT_TYPE_NONE gemeldet.

Manchmal können gespeicherte bereitgestellte Kontexte vom Netzwerk per SMS oder OTA aktualisiert werden. Wenn sich die vom Gerät bereitgestellten Kontexte ändern, ruft der mobile Breitbanddienst die OnProvisionedContextListChange-Methode von IMbnConnectionContextEvents auf. Eine Anwendung kann dann diese Methode verwenden, um die aktualisierte Liste der bereitgestellten Kontexte abzurufen.

Für die wiederherstellbaren Fehler E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED und E_MBN_BAD_SIM fragt der mobile Breitbanddienst das Gerät erneut nach diesen Informationen ab, wenn die Fehlerbedingung abgelaufen ist. Wenn für das Gerät beispielsweise eine PIN eingegeben werden muss, um die Verbindungskontexte abzurufen, wird E_MBN_PIN_REQUIRED zurückgegeben. Wenn die Anwendung eine PIN eingibt, um das Gerät zu entsperren, versucht der Dienst erneut, diese Informationen vom Gerät abzurufen. Der Dienst aktualisiert die Anwendung über die status der neuen Abfrage, indem er die OnProvisionedContextListChange-Methode von IMbnConnectionContextEvents aufruft.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnConnectionContext