WlanHostedNetworkQueryStatus-Funktion (wlanapi.h)

Artikel
03/09/2024

Die WlanHostedNetworkQueryStatus-Funktion fragt den aktuellen status des drahtlos gehosteten Netzwerks ab.

Syntax

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

Parameter

[in] hClientHandle

Das Sitzungshandle des Clients, das von einem vorherigen Aufruf der WlanOpenHandle-Funktion zurückgegeben wurde.

[out] ppWlanHostedNetworkStatus

Bei der Eingabe muss dieser Parameter NULL sein.

Bei der Ausgabe empfängt dieser Parameter einen Zeiger auf den aktuellen status des drahtlos gehosteten Netzwerks, wenn der Aufruf der WlanHostedNetworkQueryStatus-Funktion erfolgreich ist. Der aktuelle status wird in einer WLAN_HOSTED_NETWORK_STATUS-Struktur zurückgegeben.

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
ERROR_INVALID_HANDLE	Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle nicht in der Handle-Tabelle gefunden wurde.
ERROR_INVALID_PARAMETER	Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt: hClientHandle ist NULL. ppWlanHostedNetworkStatus ist NULL. pvReserved ist nicht NULL.
ERROR_INVALID_STATE	Die Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang auszuführen. Dies kann auftreten, wenn das drahtlos gehostete Netzwerk während des Herunterfahrens war.
ERROR_SERVICE_NOT_ACTIVE	Der Dienst wurde nicht gestartet. Dieser Fehler wird zurückgegeben, wenn der WLAN AutoConfig-Dienst nicht ausgeführt wird.
Andere	Verschiedene RPC- und andere Fehlercodes. Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die WlanHostedNetworkQueryStatus-Funktion ist eine Erweiterung für native Drahtlos-APIs, die hinzugefügt wurden, um das gehostete Drahtlosnetzwerk unter Windows 7 und windows Server 2008 R2 mit installiertem WLAN-Dienst zu unterstützen.

Eine Clientanwendung ruft die WlanHostedNetworkQueryStatus-Funktion auf, um den aktuellen status des drahtlosen gehosteten Netzwerks abzufragen. Diese Funktion ändert den Zustand des gehosteten Drahtlosnetzwerks nicht.

Wenn die Funktion erfolgreich ist, verweist der parameter ppWlanHostedNetworkStatus auf eine WLAN_HOSTED_NETWORK_STATUS-Struktur mit dem aktuellen status. Der für die zurückgegebene WLAN_HOSTED_NETWORK_STATUS-Struktur verwendete Arbeitsspeicher sollte nach der Verwendung durch Aufrufen der WlanFreeMemory-Funktion freigegeben werden.

Jeder Benutzer kann die WlanHostedNetworkQueryStatus-Funktion aufrufen, um das gehostete Netzwerk abzufragen. 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 gehosteter netzwerkfähiger Drahtlosadapter vorhanden ist. Dieses virtuelle Gerät wird normalerweise im "Netzwerkordner Connections" als "Drahtlose Netzwerkverbindung 2" mit dem Gerätenamen "Microsoft Virtual WiFi Miniport-Adapter" angezeigt, wenn der Computer über einen einzelnen drahtlosen Netzwerkadapter 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 verfügbar, wobei der Wireless LAN-Dienst installiert ist.

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 (einschließlich Wlanapi.h)
Bibliothek	Wlanapi.lib
DLL	Wlanapi.dll