IMbnInterface::SetPreferredProviders-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.
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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt. |
|
Die Schnittstelle ist ungültig, wahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde. |
|
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 |