WlanHostedNetworkInitSettings-Funktion (wlanapi.h)

Artikel
03/13/2024

Die WlanHostedNetworkInitSettings-Funktion konfiguriert und speichert die Netzwerkverbindungseinstellungen (z. B. SSID und maximale Anzahl von Peers) im gehosteten Drahtlosnetzwerk, wenn diese Einstellungen noch nicht konfiguriert sind.

Syntax

DWORD WlanHostedNetworkInitSettings(
  [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 den Fehlergrund empfängt, wenn der Aufruf der WlanHostedNetworkInitSettings-Funktion fehlschlägt . Mögliche Werte für den Fehlergrund stammen aus dem 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 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. 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 Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die WlanHostedNetworkInitSettings-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 WlanHostedNetworkInitSettings-Funktion auf, um die Netzwerkverbindungseinstellungen (z. B. SSID und maximale Anzahl von Peers) im gehosteten Drahtlosnetzwerk zu konfigurieren und zu speichern, wenn die Verbindungseinstellungen nicht bereits konfiguriert sind. Wenn die Netzwerkeinstellungen für die Einstellungen des gehosteten Drahtlosnetzwerks bereits konfiguriert sind (die WlanHostedNetworkQueryProperty-Funktion gibt keine ERROR_BAD_CONFIGURATION für das Stationsprofil oder die Verbindungseinstellungen zurück), gibt dieser Funktionsaufruf ERROR_SUCCESS zurück, ohne die Konfiguration der Netzwerkverbindungseinstellungen zu ändern.

Eine Clientanwendung sollte immer die WlanHostedNetworkInitSettings-Funktion aufrufen, bevor sie andere Features des gehosteten Netzwerks auf dem lokalen Computer verwendet. Diese Funktion initialisiert Einstellungen, die erforderlich sind, wenn das drahtlos gehostete Netzwerk zum ersten Mal auf einem lokalen Computer verwendet wird. Die WlanHostedNetworkInitSettings-Funktion ändert keine Konfiguration, wenn die Konfiguration bereits beibehalten wurde. Daher ist es sicher, die WlanHostedNetworkInitSettings-Funktion aufzurufen, wenn die Konfiguration bereits beibehalten wurde. Es wird empfohlen, dass Anwendungen, die gehostetes Netzwerk verwenden, die WlanHostedNetworkInitSettings-Funktion aufrufen, bevor sie andere gehostete Netzwerkfunktionen verwenden.

Die WlanHostedNetworkInitSettings-Funktion berechnet eine zufällige und lesbare SSID aus dem Hostnamen und berechnet einen zufälligen Primärschlüssel. Diese Funktion verwendet auch einen Wert für die maximal zulässige Anzahl von Peers, die standardmäßig auf 100 festgelegt wird. Wenn eine Anwendung eine andere SSID oder eine andere maximale Anzahl von Peers verwenden möchte, sollte die Anwendung die WlanHostedNetworkSetProperty-Funktion aufrufen, um diese vom drahtlosen gehosteten Netzwerk verwendeten Eigenschaften speziell festzulegen.

Jede durch diese Funktion verursachte Änderung des Hosted Network-Zustands wird nicht automatisch rückgängiggemacht, wenn die aufrufende Anwendung ihr aufrufende Handle schließt (durch Aufrufen von WlanCloseHandle mit dem hClientHandle-Parameter ) oder wenn der Prozess beendet wird.

Jeder Benutzer kann die WlanHostedNetworkInitSettings-Funktion aufrufen, um Die Einstellungen für die Speichernetzwerkverbindung im gehosteten Netzwerk zu konfigurieren und beizubehalten. Wenn das drahtlos gehostete Netzwerk bereits konfiguriert wurde, tut diese Funktion nichts und gibt ERROR_SUCCESS zurück.

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