IMbnMultiCarrierEvents::OnSetHomeProviderComplete-Methode (mbnapi.h)

Artikel
03/01/2024

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.

Diese Benachrichtigungsmethode wird vom Mobilen Breitbanddienst aufgerufen, um den Abschluss eines SetHomeProvider-Vorgangs anzugeben.

Syntax

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Parameter

[in] mbnInterface

Ein IMbnMultiCarrier-Objekt , das den SetHomeProvider-Vorgang des mobilen Breitbandgeräts darstellt.

[in] requestID

Die Anforderungs-ID, die vom Mobilen Breitbanddienst dem SetHomeProvider-Vorgang zugewiesen wurde.

[in] status

Ein status Code, der das Ergebnis von SetHomeProvider angibt.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
E_MBN_PROVIDER_NOT_VISIBLE	Der angeforderte Anbieter ist nicht sichtbar.
E_INVALIDARG	Ungültige Eingabe im Registrierungsmodus, die als Eingabe angegebene Anbieter-ID ist länger als die maximale Länge von 7 Zeichen, oder die bereitgestellte Datenklasse ist ungültig. Der mobile Breitbanddienst sendet die Anforderung nicht an das Gerät, wenn in der Eingabe ungültige Argumente angegeben werden. Im manuellen Registrierungsmodus bedeutet dies, dass der angeforderte Anbieter verboten ist.
E_FAIL	Der Vorgang konnte nicht abgeschlossen werden. Weitere Informationen finden Sie im Netzwerkfehlercode.
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.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Wenn statusS_OK ist, wurde der Basisanbieter für die Schnittstelle von SetHomeProvider erfolgreich auf den neuen Anbieter festgelegt. Andernfalls wird der ursprüngliche Basisanbieter nicht geändert, und die vorherigen Zustände wie Verbindung, Paketdienst usw. der Schnittstelle bleiben unverändert.

Anforderungen

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

Weitere Informationen

IMbnMultiCarrierEvents

Freigeben über