IMbnInterface::ScanNetwork-Methode (mbnapi.h)

Artikel
03/04/2024

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
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. Höchstwahrscheinlich, weil das mobile Breitbandgerät aus dem System entfernt wurde.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	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

Weitere Informationen

IMbnInterface

Freigeben über