IMbnInterfaceEvents::OnSetPreferredProvidersComplete-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.

Diese Benachrichtigungsmethode wird vom Mobile Broadband-Dienst aufgerufen, um den Abschluss eines SetPreferredProviders-Vorgangs anzugeben.

Syntax

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parameter

[in] newInterface

Ein IMbnInterface , das ein Gerät darstellt, auf dem dieser Vorgang ausgeführt wurde.

[in] requestID

Die Anforderungs-ID, die vom Mobilen Breitbanddienst für diesen asynchronen Vorgang zugewiesen wurde.

[in] status

Der Vorgangsabschluss status.

In der folgenden Tabelle sind die gültigen Werte für diese status aufgeführt.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
E_MBN_PIN_REQUIRED	Für das Gerät muss eine PIN eingegeben werden, damit dieser Vorgang abgeschlossen werden kann.
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_NOT_SUPPORTED)	Dieser Vorgang wird vom Gerät nicht unterstützt.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Wenn der Vorgang erfolgreich abgeschlossen wurde, d. h. wenn statusS_OK ist, kann die Anwendung die GetPreferredProviders-Methode des übergebenen IMbnInterface aufrufen, um eine aktualisierte Liste der bevorzugten Anbieter abzurufen.

Wenn mehrere Anwendungen für Benachrichtigungen registriert sind, wird diese Methode für alle registrierten Anwendungen aufgerufen. Dies bedeutet, dass eine Anwendung, die den Updatevorgang nicht initiiert hat, auch eine Benachrichtigung erhält.

Wenn ein Aufruf der SetPreferredProviders-Methode von IMbnInterface zu einer Änderung in der Liste der bevorzugten Anbieter führt, wird die OnPreferredProvidersChange-Methode von IMbnInterfaceEvents nicht aufgerufen.

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

IMbnInterfaceEvents

Freigeben über