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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. homeProvider enthält gültige Werte. |
|
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. |
|
Für das Gerät muss für diesen Vorgang eine PIN eingegeben werden. |
|
Die SIM-Karte wird nicht eingefügt. |
|
Eine ungültige SIM-Karte wird in das Gerät eingefügt. |
|
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 |