IMbnInterface::SetPreferredProviders-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 die Liste der bevorzugten Anbieter für das Gerät.

Syntax

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

Parameter

[in] preferredProviders

Ein Array von MBN_PROVIDER Strukturen, das die Liste der bevorzugten Anbieter enthält.

[out] 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	Die Schnittstelle ist ungültig, wahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die Schnittstelle ist ungültig. Wahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde.

Hinweise

Die SetPreferredProviders-Methode initiiert eine Aktualisierung der Liste des bevorzugten Anbieters für die Schnittstelle. Dies ist ein asynchroner Vorgang, und der Methodenaufruf wird sofort zurückgegeben. Wenn diese Methode erfolgreich zurückgegeben wird (mit S_OK), benachrichtigt das Betriebssystem die aufrufende Anwendung über den Abschluss status dieses Vorgangs, indem es die OnSetPreferredProvidersComplete-Methode von IMbnInterfaceEvents aufruft.

Wenn das Gerät vor Abschluss dieses Vorgangs aus dem System entfernt wird, gibt es keine Garantie, dass die Vervollständigungsbenachrichtigung von der aufrufenden Anwendung empfangen wird.

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

Share via