IMbnMultiCarrier::ScanNetwork-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.
Scannt das Netzwerk, um eine Liste der sichtbaren Anbieter für ein Gerät mit mehreren Trägern abzurufen.
Syntax
HRESULT ScanNetwork(
[out] ULONG *requestID
);
Parameter
[out] requestID
Zeiger auf die Anforderungs-ID, die vom Betriebssystem für diese Anforderung festgelegt wurde. Die asynchrone Antwort von OnScanNetworkComplete 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. |
|
Der Vorgang wird vom Gerät nicht unterstützt. Dies kann von Geräten zurückgegeben werden, die multi-Carrier nicht unterstützen. |
Hinweise
Diese Methode initiiert einen Netzwerkscanvorgang. Nach erfolgreicher Ausführung füllt es den Cache des Betriebssystems mit sichtbaren Anbietern auf, und Anwendungen können die GetVisibleProviders-Methode von IMbnMultiCarrier aufrufen, um eine Liste der sichtbaren Netzwerke abzurufen.
Dies ist ein zeitaufwendiger Vorgang. Daher sollten Anwendungen zuerst GetVisibleProviders aufrufen und ScanNetwork nur dann aufrufen, wenn die zwischengespeicherten Informationen alt sind.
Dies ist ein asynchroner Vorgang, und ScanNetwork wird sofort zurückgegeben. Wenn diese Methode erfolgreich zurückgegeben wird (mit S_OK), ruft das Betriebssystem nach Abschluss des Scanvorgangs die OnScanNetworkComplete-Methode von IMbnMultiCarrierEvents auf, um die Anwendung über den Abschluss des Vorgangs zu benachrichtigen.
Wenn das Gerät vor Abschluss dieses Vorgangs aus dem System entfernt wird, gibt es keine Garantie, dass die Vervollständigungsbenachrichtigung von der Anwendung empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |