WlanHostedNetworkForceStop-Funktion (wlanapi.h)
Die WlanHostedNetworkForceStop-Funktion übergibt das drahtlose gehostete Netzwerk in das wlan_hosted_network_idle , ohne die Anforderung dem Aufrufhandle der Anwendung zuzuordnen.
Syntax
DWORD WlanHostedNetworkForceStop(
[in] HANDLE hClientHandle,
[out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
PVOID pvReserved
);
Parameter
[in] hClientHandle
Das Sitzungshandle des Clients, das von einem vorherigen Aufruf der WlanOpenHandle-Funktion zurückgegeben wurde.
[out, optional] pFailReason
Ein optionaler Zeiger auf einen Wert, der die Fehlerursache empfängt, wenn der Aufruf der WlanHostedNetworkForceStop-Funktion fehlschlägt. Mögliche Werte für den Fehlergrund stammen vom WLAN_HOSTED_NETWORK_REASON Enumerationstyp, der in der Headerdatei "Wlanapi.h " definiert ist.
pvReserved
Für die zukünftige Verwendung reserviert. Dieser Parameter muss NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.
| Rückgabecode | Beschreibung |
|---|---|
|
Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde. |
|
Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt:
|
|
Die Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang auszuführen. |
|
Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird. |
|
Verschiedene RPC- und andere Fehlercodes. Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen. |
Hinweise
Die WlanHostedNetworkForceStop-Funktion ist eine Erweiterung für native Drahtlose APIs, die hinzugefügt werden, um das drahtlose gehostete Netzwerk unter Windows 7 und Windows Server 2008 R2 mit installiertem Wireless LAN-Dienst zu unterstützen.
Eine Clientanwendung ruft die WlanHostedNetworkForceStop-Funktion auf, um das Beenden des gehosteten Netzwerks zu erzwingen und das drahtlose gehostete Netzwerk in das wlan_hosted_network_idle zu übertragen, ohne die Anforderung dem Aufrufhandle der Anwendung zuzuordnen. Ein Client ruft in der Regel die WlanHostedNetworkForceStop-Funktion auf, um einen früheren erfolgreichen Aufruf der WlanHostedNetworkForceStart-Funktion abzugleichen .
Die WlanHostedNetworkForceStop-Funktion kann fehlschlagen, wenn der Zustand des gehosteten Netzwerks nicht wlan_hosted_network_active ist.
Jede durch diese Funktion verursachte Änderung des Zustands des gehosteten Netzwerks wird nicht automatisch rückgängig, wenn die aufrufende Anwendung ihr Aufrufhandle schließt (durch Aufrufen von WlanCloseHandle mit dem hClientHandle-Parameter ) oder wenn der Prozess beendet wird.
Eine Anwendung kann die WlanHostedNetworkForceStop-Funktion aufrufen, um das gehostete Netzwerk nach einem vorherigen Aufruf von WlanHostedNetworkForceStart durch einen Systembenutzer mit erhöhten Rechten zu beenden, der die erhöhten Energieanforderungen für die Ausführung des gehosteten Drahtlosnetzwerks für längere Zeit akzeptiert hat.
Jeder Benutzer kann die WlanHostedNetworkForceStop-Funktion aufrufen, um das Beenden des gehosteten Netzwerks zu erzwingen. Die Möglichkeit, das drahtlos gehostete Netzwerk zu aktivieren, kann jedoch durch Gruppenrichtlinien in einer Domäne eingeschränkt werden.
Unter Windows 7 und höher installiert das Betriebssystem ein virtuelles Gerät, wenn auf dem Computer ein gehostetes Netzwerkfähiger Drahtlosadapter vorhanden ist. Dieses virtuelle Gerät wird normalerweise im Ordner "Netzwerk Connections" als "Drahtlose Netzwerkverbindung 2" mit dem Gerätenamen "Microsoft Virtual WiFi Miniport-Adapter" angezeigt, wenn der Computer über einen einzelnen Drahtlosnetzwerkadapter verfügt. Dieses virtuelle Gerät wird ausschließlich zum Ausführen von SoftAP-Verbindungen (Software Access Point) verwendet und ist nicht in der Liste enthalten, die von der WlanEnumInterfaces-Funktion zurückgegeben wird. Die Lebensdauer dieses virtuellen Geräts ist an den physischen Drahtlosadapter gebunden. Wenn der physische Drahtlosadapter deaktiviert ist, wird auch dieses virtuelle Gerät entfernt. Dieses Feature ist auch unter Windows Server 2008 R2 mit installiertem WLAN-Dienst verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wlanapi.h (wlanapi.h einschließen) |
| Bibliothek | Wlanapi.lib |
| DLL | Wlanapi.dll |
Weitere Informationen
Informationen zum drahtlos gehosteten Netzwerk
Verwenden der drahtlos gehosteten Netzwerk- und Internetverbindungsfreigabe