WLAN_HOSTED_NETWORK_REASON-Enumeration (wlanapi.h)

Artikel
08/28/2023

Der WLAN_HOSTED_NETWORK_REASON enumerierte Typ gibt die möglichen Werte für das Ergebnis eines Drahtlosfunktionsaufrufs des gehosteten Netzwerks an.

Syntax

typedef enum _WLAN_HOSTED_NETWORK_REASON {
  wlan_hosted_network_reason_success = 0,
  wlan_hosted_network_reason_unspecified,
  wlan_hosted_network_reason_bad_parameters,
  wlan_hosted_network_reason_service_shutting_down,
  wlan_hosted_network_reason_insufficient_resources,
  wlan_hosted_network_reason_elevation_required,
  wlan_hosted_network_reason_read_only,
  wlan_hosted_network_reason_persistence_failed,
  wlan_hosted_network_reason_crypt_error,
  wlan_hosted_network_reason_impersonation,
  wlan_hosted_network_reason_stop_before_start,
  wlan_hosted_network_reason_interface_available,
  wlan_hosted_network_reason_interface_unavailable,
  wlan_hosted_network_reason_miniport_stopped,
  wlan_hosted_network_reason_miniport_started,
  wlan_hosted_network_reason_incompatible_connection_started,
  wlan_hosted_network_reason_incompatible_connection_stopped,
  wlan_hosted_network_reason_user_action,
  wlan_hosted_network_reason_client_abort,
  wlan_hosted_network_reason_ap_start_failed,
  wlan_hosted_network_reason_peer_arrived,
  wlan_hosted_network_reason_peer_departed,
  wlan_hosted_network_reason_peer_timeout,
  wlan_hosted_network_reason_gp_denied,
  wlan_hosted_network_reason_service_unavailable,
  wlan_hosted_network_reason_device_change,
  wlan_hosted_network_reason_properties_change,
  wlan_hosted_network_reason_virtual_station_blocking_use,
  wlan_hosted_network_reason_service_available_on_virtual_station
} WLAN_HOSTED_NETWORK_REASON, *PWLAN_HOSTED_NETWORK_REASON;

Konstanten


`wlan_hosted_network_reason_success` Wert: 0 Der Vorgang wurde durchgeführt.
`wlan_hosted_network_reason_unspecified` Unbekannter Fehler.
`wlan_hosted_network_reason_bad_parameters` Ungültige Parameter. Dieser Grundcode wird beispielsweise zurückgegeben, wenn eine Anwendung nicht über das richtige Handle (das von der WlanOpenHandle-Funktion zurückgegebene Handle) auf den Clientkontext verweisen konnte.
`wlan_hosted_network_reason_service_shutting_down` Der Dienst wird heruntergefahren.
`wlan_hosted_network_reason_insufficient_resources` Der Dienst hat keine Ressourcen mehr.
`wlan_hosted_network_reason_elevation_required` Für diesen Vorgang ist eine Erhöhung erforderlich.
`wlan_hosted_network_reason_read_only` Es wurde versucht, schreibgeschützte Daten zu schreiben.
`wlan_hosted_network_reason_persistence_failed` Fehler bei der Datenpersistenz.
`wlan_hosted_network_reason_crypt_error` Ein kryptografischer Fehler ist aufgetreten.
`wlan_hosted_network_reason_impersonation` Fehler beim Benutzeridentitätswechsel.
`wlan_hosted_network_reason_stop_before_start` Es wurde eine falsche Funktionsaufrufsequenz erstellt.
`wlan_hosted_network_reason_interface_available` Eine drahtlose Schnittstelle ist verfügbar.
`wlan_hosted_network_reason_interface_unavailable` Eine drahtlose Schnittstelle ist nicht mehr verfügbar. Aus diesem Grund wird der Code von den drahtlos gehosteten Netzwerkfunktionen jedes Mal zurückgegeben, wenn der Netzwerkzustand des gehosteten Drahtlosnetzwerks wlan_hosted_network_unavailable wird. Wenn das drahtlose gehostete Netzwerk beispielsweise durch eine Gruppenrichtlinie in einer Domäne deaktiviert wird, wird der Netzwerkstatus des gehosteten Drahtlosnetzwerks wlan_hosted_network_unavailable. In diesem Fall würden alle Aufrufe der Funktion WlanHostedNetworkStartUsing oder WlanHostedNetworkForceStart diesen Grundcode zurückgeben.
`wlan_hosted_network_reason_miniport_stopped` Der Wireless-Miniporttreiber hat das gehostete Netzwerk beendet.
`wlan_hosted_network_reason_miniport_started` Der Wireless-Miniporttreiber status geändert.
`wlan_hosted_network_reason_incompatible_connection_started` Eine inkompatible Verbindung wurde gestartet. Eine inkompatible Verbindung bezieht sich auf einen der folgenden Fälle: Auf dem Adapter der primären Station wird eine Ad-hoc-Drahtlosverbindung gestartet. Die Netzwerküberwachung wird auf dem Adapter der primären Station durch eine Anwendung (z. B. Netzwerkmonitor) gestartet, die die WlanSetInterface-Funktion aufruft, wobei der OpCode-Parameter auf wlan_intf_opcode_current_operation_mode festgelegt ist und der pData-Parameter auf eine ULONG verweist, die DOT11_OPERATION_MODE_NETWORK_MONITOR enthält. Eine drahtlose Verbindung wird im abgesicherten FIPS-Modus auf dem Adapter der primären Station gestartet. Der abgesicherte FIPS-Modus wird im Profil der drahtlosen Verbindung angegeben. Weitere Informationen finden Sie im FIPSMode-Element. Windows beendet das drahtlose gehostete Netzwerk auf dem softwarebasierten AP-Adapter (Wireless Access Point), wenn eine inkompatible Verbindung mit dem Adapter der primären Station gestartet wird. Der Netzwerkstatus des drahtlos gehosteten Netzwerks wird wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` Eine inkompatible Verbindung wurde beendet. Eine inkompatible Verbindung, die zuvor auf dem Adapter der primären Station (wlan_hosted_network_reason_incompatible_connection_started) gestartet wurde, aber die inkompatible Verbindung wurde beendet. Wenn das drahtlose gehostete Netzwerk zuvor aufgrund einer inkompatiblen Verbindung beendet wurde, startet Windows das drahtlose gehostete Netzwerk nicht automatisch neu. Anwendungen können das drahtlos gehostete Netzwerk auf dem AP-Adapter neu starten, indem sie die Funktion WlanHostedNetworkStartUsing oder WlanHostedNetworkForceStart aufrufen .
`wlan_hosted_network_reason_user_action` Es ist eine Zustandsänderung aufgetreten, die durch eine explizite Benutzeraktion verursacht wurde.
`wlan_hosted_network_reason_client_abort` Es ist eine Zustandsänderung aufgetreten, die durch einen Clientabbruch verursacht wurde.
`wlan_hosted_network_reason_ap_start_failed` Der Treiber für das drahtlose gehostete Netzwerk konnte nicht gestartet werden.
`wlan_hosted_network_reason_peer_arrived` Ein Peer, der mit dem drahtlosen gehosteten Netzwerk verbunden ist.
`wlan_hosted_network_reason_peer_departed` Ein Peer, der vom drahtlosen gehosteten Netzwerk getrennt ist.
`wlan_hosted_network_reason_peer_timeout` Ein Peertimeout.
`wlan_hosted_network_reason_gp_denied` Der Vorgang wurde durch eine Gruppenrichtlinie abgelehnt.
`wlan_hosted_network_reason_service_unavailable` Der WLAN-Dienst wird nicht ausgeführt.
`wlan_hosted_network_reason_device_change` Der vom drahtlos gehosteten Netzwerk verwendete Drahtlosadapter wurde geändert.
`wlan_hosted_network_reason_properties_change` Die Eigenschaften des drahtlosen gehosteten Netzwerks wurden geändert.
`wlan_hosted_network_reason_virtual_station_blocking_use` Eine virtuelle Station ist aktiv und blockiert den Betrieb.
`wlan_hosted_network_reason_service_available_on_virtual_station` Ein identischer Dienst ist auf einer virtuellen Station verfügbar.

Hinweise

Der WLAN_HOSTED_NETWORK_REASON aufgelisteten Typs ist eine Erweiterung für native Drahtlos-APIs, die hinzugefügt werden, um das gehostete Drahtlosnetzwerk unter Windows 7 und höher zu unterstützen.

Die WLAN_HOSTED_NETWORK_REASON listet die möglichen Gründe auf, aus denen ein Funkfunktionsaufruf des gehosteten Netzwerks fehlgeschlagen ist, oder die Gründe, warum eine bestimmte Benachrichtigung über ein gehostetes drahtloses Netzwerk generiert wurde.

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 "Netzwerkverbindungen" 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.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	wlanapi.h (wlanapi.h einschließen)