IMbnInterface::GetHomeProvider-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 den Heimanbieter ab.

Syntax

HRESULT GetHomeProvider(
  [out, retval] MBN_PROVIDER *homeProvider
);

Parameter

[out, retval] homeProvider

Ein Zeiger auf eine MBN_PROVIDER-Struktur , die den Basisanbieter darstellt. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter NULL. Nach Abschluss muss die aufrufende Anwendung den Speicher freigeben, der der providerID- und providerName-Member von MBN_PROVIDER zugewiesen ist, indem SysFreeString aufgerufen wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen. homeProvider enthält gültige Werte.
E_PENDING	Die Informationen sind nicht verfügbar. Der Mobile Broadband-Dienst versucht derzeit, den Heimanbieter zu erhalten. Die aufrufende Anwendung kann benachrichtigt werden, wenn der Homeanbieter verfügbar ist, indem sie sich für die OnHomeProviderAvailable-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. Auf der SIM sind beispielsweise keine Informationen des Heimanbieters bereitgestellt.

Hinweise

GetHomeProvider gibt die Informationen des Heimanbieters für das Gerät zurück. Das DataClass-Feld der zurückgegebenen MBN_PROVIDER-Struktur sollte ignoriert werden.

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 für den Heimanbieter ab, wenn die Fehlerbedingung abgelaufen ist. Wenn für das Gerät beispielsweise eine PIN eingegeben werden muss, um diese Informationen abzurufen, wird E_MBN_PIN_REQUIRED zurückgegeben. Wenn die Anwendung die PIN zum Entsperren des Geräts eingibt, versucht der mobile Breitbanddienst erneut, diese Informationen vom Gerät abzurufen. Das System aktualisiert die Anwendung über die status der neuen Abfrage, indem die OnHomeProviderAvailable-Methode von IMbnInterfaceEvents aufgerufen wird.

Die registrierte OnHomeProviderAvailable-Methode von IMbnInterfaceEvents kann entweder aufgerufen werden, wenn Informationen des Homeanbieters verfügbar sind, oder die neue Abfrage wurde mit einem Fehler abgeschlossen. Sobald diese Funktion erfolgreich zurückgegeben wird, werden sich diese Informationen nie ändern.

Anforderungen

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