IMbnMultiCarrier::SetHomeProvider-Methode (mbnapi.h)

Artikel
08/24/2023

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.

Updates den Heimanbieter für ein Gerät mit mehreren Trägern.

Syntax

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

Parameter

[in] homeProvider

Eine MBN_PROVIDER2-Struktur , die den Basisanbieter enthält.

Hinweis

Die Elemente SignalStrength und SignalError müssen 0 sein.

[out] requestID

Ein Zeiger auf die Vom Betriebssystem für diese Anforderung festgelegte Anforderungs-ID. Die asynchrone Antwort von OnSetHomeProviderComplete enthält dieselbe requestID.

Zeiger auf die Anforderungs-ID, die vom Betriebssystem für diese Anforderung festgelegt wurde. Die asynchrone Antwort enthält dieselbe requestID.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.
E_HANDLE	Ungültige Schnittstelle. Das mobile Breitbandgerät wurde wahrscheinlich aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Der Vorgang wird vom Gerät nicht unterstützt. Dies kann von Geräten zurückgegeben werden, die mehrere Netzbetreiber nicht unterstützen.

Hinweise

Die SetHomeProvider-Methode initiiert ein Update des Basisanbieters für die Schnittstelle. Dies ist ein asynchroner Vorgang, und der Methodenaufruf wird sofort zurückgegeben. Wenn diese Methode erfolgreich mit S_OK zurückgibt, benachrichtigt Windows die aufrufende Anwendung über den Abschluss status dieses Vorgangs, indem die OnSetHomeProviderComplete-Methode von IMbnMultiCarrierEvents aufgerufen wird.

Das Gerät wird dann automatisch beim neuen Netzwerk registriert und gibt eine Änderung des Registrierungsstatus an. Das Gerät wird weiterhin über Windows-Neustarts für dieses neue Heimnetzwerk registriert, es sei denn , SetHomeProvider wird erneut verwendet, um einen neuen Heimanbieter festzulegen.

Wenn das Gerät aus dem System entfernt wird, bevor dieser Vorgang abgeschlossen ist, gibt es keine Garantie, dass die Abschlussbenachrichtigung von der aufrufenden Anwendung empfangen wird.

Anforderungen


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

Weitere Informationen

IMbnMultiCarrier

Freigeben über