WlanHostedNetworkRefreshSecuritySettings-Funktion (wlanapi.h)

Artikel
03/13/2024

Die Funktion WlanHostedNetworkRefreshSecuritySettings aktualisiert die konfigurierbaren und automatisch generierten Teile der Sicherheitseinstellungen für das gehostete Drahtlosnetzwerk.

Syntax

DWORD WlanHostedNetworkRefreshSecuritySettings(
  [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 WlanHostedNetworkRefreshSecuritySettings-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
ERROR_INVALID_HANDLE	Ein Handle ist ungültig. Dieser Fehler wird zurückgegeben, wenn das im hClientHandle-Parameter angegebene Handle in der Handletabelle nicht gefunden wurde.
ERROR_INVALID_PARAMETER	Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen auftritt: hClientHandle ist NULL. pvReserved ist nicht NULL.
ERROR_INVALID_STATE	Die Ressource befindet sich nicht im richtigen Zustand, um den angeforderten Vorgang auszuführen.
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 Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

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

Eine Clientanwendung ruft die WlanHostedNetworkRefreshSecuritySettings-Funktion auf, um eine Aktualisierung der konfigurierbaren und automatisch generierten Teile der Sicherheitseinstellungen (primärer Schlüssel) im gehosteten Drahtlosnetzwerk zu erzwingen.

Eine Anwendung kann die Funktion WlanHostedNetworkRefreshSecuritySettings aufrufen, nachdem sichergestellt wurde, dass der Benutzer die Auswirkungen der Aktualisierung der Sicherheitseinstellungen akzeptiert. Um erfolgreich zu sein, muss diese Funktion die neuen Einstellungen beibehalten, sodass der Zustand des gehosteten Netzwerks in wlan_hosted_network_idle übertragen werden muss, wenn er gerade ausgeführt wird (wlan_hosted_network_active).

Hinweis Alle Netzwerkclients (PCs oder Geräte) im drahtlosen gehosteten Netzwerk müssen nach dem Aufruf der WlanHostedNetworkRefreshSecuritySettings-Funktion neu konfiguriert werden, wenn ihre fortgesetzte Nutzung ein Ziel ist. Eine Anwendung ruft diese Funktion in der Regel in Situationen auf, in denen der Benutzer das Gefühl hat, dass die Sicherheit des vorherigen Primärschlüssels, der vom drahtlosen gehosteten Netzwerk für die Sicherheit verwendet wurde, verletzt wurde. Beachten Sie, dass die Funktion WlanHostedNetworkRefreshSecuritySettings den sekundären Schlüssel nicht ändert oder zurücksetzt.

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.

Jeder Benutzer kann die Funktion WlanHostedNetworkRefreshSecuritySettings aufrufen, um die Sicherheitseinstellungen im gehosteten Netzwerk zu aktualisieren. 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