IMbnInterface::GetPreferredProviders-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 Liste der bevorzugten Anbieter ab.

Syntax

HRESULT GetPreferredProviders(
  [out, retval] SAFEARRAY **preferredProviders
);

Parameter

[out, retval] preferredProviders

Zeiger auf ein Array von MBN_PROVIDER Strukturen, das die Liste der bevorzugten Anbieter enthält. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter NULL. Wenn GetPreferredProvidersS_OK zurückgibt, 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. preferredProviders enthält gültige Werte.
E_PENDING	Die Informationen sind nicht verfügbar. Der mobile Breitbanddienst sucht derzeit nach der Liste der bevorzugten Anbieter. Die aufrufende Anwendung kann benachrichtigt werden, wenn die Daten verfügbar sind, indem sie sich für die OnPreferredProvidersChange-Methode von IMbnInterfaceEvents registriert.
E_MBN_PIN_REQUIRED	Für das Gerät muss für diesen Vorgang eine PIN eingegeben werden.
E_MBN_SIM_NOT_INSERTED	Die SIM-Karte wird nicht eingefügt.
E_MBN_BAD_SIM	Eine ungültige SIM-Karte wird in das Gerät eingefügt.
HRESULT_FROM_WIN32(ERROR_READ_FAULT)	Aus der SIM-Karte oder dem Gerätespeicher kann nicht gelesen werden. Beispielsweise sind auf der SIM keine bevorzugten Anbieterinformationen bereitgestellt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Dieser Vorgang wird vom Gerät nicht unterstützt. CDMA-Geräte geben diesen Wert immer zurück.

Hinweise

GetPreferredProviders gibt die Liste der Anbieter zurück, die in der Liste der bevorzugten Anbieter der Schnittstelle gespeichert sind.

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 der Anbieterliste ab, wenn die Fehlerbedingung abgelaufen ist. Wenn für das Gerät beispielsweise eine PIN eingegeben werden muss, um die Anbieterliste abzurufen, gibt GetPreferredProvidersE_MBN_PIN_REQUIRED zurück. Wenn eine Anwendung eine PIN eingibt, um das Gerät zu entsperren, versucht der mobile Breitbanddienst erneut, diese Informationen vom Gerät abzurufen.

Wenn das Betriebssystem das Gerät abfragt, um die Anbieterliste abzurufen, nachdem ein wiederherstellbarer Fehler aufgetreten ist, gibt GetPreferredProviders sofort E_PENDING zurück. Sobald die neue Abfrage abgeschlossen ist, wird eine Benachrichtigung mithilfe der entsprechenden Rückrufmethode an die aufrufende Anwendung gesendet. Beispielsweise würde nach einem erfolgreichen PIN-Entsperrvorgang die OnEnterComplete-Methode von IMbnPinEvents aufgerufen. Nach der Wiederherstellung von einem SIM-Karte Fehler wird die OnReadyStateChange-Methode von IMbnInterfaceEvents aufgerufen.

Der Mobile Broadband-Dienst aktualisiert die Anwendung über die status einer neuen Abfrage, indem die OnPreferredProvidersChange-Methode von IMbnInterfaceEvents aufgerufen wird.

In einigen Fällen kann die Liste der bevorzugten Anbieter des Geräts über das Netzwerk per SMS oder OTA (Over-the-Air-Update) aktualisiert werden. Das Betriebssystem benachrichtigt die Anwendung über änderungen in der Liste des bevorzugten Anbieters, indem es die OnPreferredProvidersChange-Methode von IMbnInterfaceEvents aufruft.

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