IMbnInterface::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.
Überprüft das Netzwerk asynchron, um eine Liste der sichtbaren Anbieter zu erhalten.
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 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. Höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde. |
|
Die Schnittstelle ist ungültig. Höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde. |
Hinweise
Diese Methode initiiert einen Netzwerkscanvorgang. Nach erfolgreicher Ausführung wird der Cache des Betriebssystems mit sichtbaren Anbietern aufgefüllt, und Anwendungen können die GetVisibleProviders-Methode von IMbnInterface aufrufen, um eine Liste der sichtbaren Netzwerke abzurufen.
Dies ist ein zeitaufwändiger Vorgang. Daher sollten Anwendungen zuerst GetVisibleProviders 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 IMbnInterfaceEvents 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 Abschlussbenachrichtigung von der Anwendung empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |