Freigeben über


WLAN_HOSTED_NETWORK_REASON-Enumeration (wlanapi.h)

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)

Weitere Informationen

WlanEnumInterfaces

WlanHostedNetworkForceStart

WlanHostedNetworkForceStop

WlanHostedNetworkInitSettings

WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkRefreshSecuritySettings

WlanHostedNetworkSetProperty

WlanHostedNetworkSetSecondaryKey

WlanHostedNetworkStartUsing

WlanHostedNetworkStopUsing