enumerasi WLAN_HOSTED_NETWORK_REASON (wlanapi.h)

Artikel
03/08/2023

Jenis WLAN_HOSTED_NETWORK_REASON yang dijumlahkan menentukan nilai yang mungkin untuk hasil panggilan fungsi Jaringan yang Dihosting nirkabel.

Sintaks

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;

Konstanta


`wlan_hosted_network_reason_success` Nilai: 0 Operasi berhasil.
`wlan_hosted_network_reason_unspecified` Kesalahan tidak diketahui.
`wlan_hosted_network_reason_bad_parameters` Parameter buruk. Misalnya, kode alasan ini dikembalikan jika aplikasi gagal mereferensikan konteks klien dari handel yang benar (handel yang dikembalikan oleh fungsi WlanOpenHandle ).
`wlan_hosted_network_reason_service_shutting_down` Layanan dimatikan.
`wlan_hosted_network_reason_insufficient_resources` Layanan kehabisan sumber daya.
`wlan_hosted_network_reason_elevation_required` Operasi ini membutuhkan elevasi.
`wlan_hosted_network_reason_read_only` Upaya dilakukan untuk menulis data baca-saja.
`wlan_hosted_network_reason_persistence_failed` Persistensi data gagal.
`wlan_hosted_network_reason_crypt_error` Terjadi kesalahan kriptografi.
`wlan_hosted_network_reason_impersonation` Peniruan identitas pengguna gagal.
`wlan_hosted_network_reason_stop_before_start` Urutan panggilan fungsi yang salah dibuat.
`wlan_hosted_network_reason_interface_available` Antarmuka nirkabel telah tersedia.
`wlan_hosted_network_reason_interface_unavailable` Antarmuka nirkabel menjadi tidak tersedia. Alasan kode ini dikembalikan oleh fungsi Hosted Network nirkabel setiap kali status jaringan Jaringan Yang Dihosting nirkabel wlan_hosted_network_unavailable. Misalnya jika Jaringan yang Dihosting nirkabel dinonaktifkan oleh kebijakan grup pada domain, maka status jaringan Jaringan yang Dihosting nirkabel wlan_hosted_network_unavailable. Dalam hal ini, setiap panggilan ke fungsi WlanHostedNetworkStartUsing atau WlanHostedNetworkForceStart akan mengembalikan kode alasan ini.
`wlan_hosted_network_reason_miniport_stopped` Driver miniport nirkabel menghentikan Jaringan yang Dihosting.
`wlan_hosted_network_reason_miniport_started` Status driver miniport nirkabel berubah.
`wlan_hosted_network_reason_incompatible_connection_started` Koneksi yang tidak kompatibel dimulai. Koneksi yang tidak kompatibel mengacu pada salah satu kasus berikut: Koneksi nirkabel ad hoc dimulai pada adaptor stasiun utama. Pemantauan jaringan dimulai pada adaptor stasiun utama oleh aplikasi (Monitor Jaringan, misalnya) yang memanggil fungsi WlanSetInterface dengan parameter OpCode diatur ke wlan_intf_opcode_current_operation_mode dan parameter pData menunjuk ke ULONG yang berisi DOT11_OPERATION_MODE_NETWORK_MONITOR. Koneksi nirkabel dimulai dalam mode aman FIPS pada adaptor stasiun utama. Mode aman FIPS ditentukan dalam profil koneksi nirkabel. Untuk informasi selengkapnya, lihat Elemen FIPSMode. Windows akan menghentikan Jaringan Terhosting nirkabel pada adaptor titik akses nirkabel (AP) berbasis perangkat lunak ketika sambungan yang tidak kompatibel dimulai pada adaptor stasiun utama. Status jaringan dari status Jaringan Yang Dihosting nirkabel akan menjadi wlan_hosted_network_unavailable.
`wlan_hosted_network_reason_incompatible_connection_stopped` Koneksi yang tidak kompatibel dihentikan. Koneksi yang tidak kompatibel sebelumnya dimulai pada adaptor stasiun utama (wlan_hosted_network_reason_incompatible_connection_started), tetapi koneksi yang tidak kompatibel telah berhenti. Jika Jaringan Yang Dihosting nirkabel sebelumnya dihentikan sebagai akibat dari sambungan tak kompatibel yang dimulai, Windows tidak akan otomatis memulai ulang Jaringan Yang Dihosting nirkabel. Aplikasi dapat memulai ulang Jaringan Yang Dihosting nirkabel pada adaptor AP dengan memanggil fungsi WlanHostedNetworkStartUsing atau WlanHostedNetworkForceStart .
`wlan_hosted_network_reason_user_action` Terjadi perubahan status yang disebabkan oleh tindakan pengguna eksplisit.
`wlan_hosted_network_reason_client_abort` Terjadi perubahan status yang disebabkan oleh pembatalan klien.
`wlan_hosted_network_reason_ap_start_failed` Pengandar untuk Jaringan Yang Dihosting nirkabel gagal dimulai.
`wlan_hosted_network_reason_peer_arrived` Serekan yang tersambung ke Jaringan Yang Dihosting nirkabel.
`wlan_hosted_network_reason_peer_departed` Serekan terputus dari Jaringan yang Dihosting nirkabel.
`wlan_hosted_network_reason_peer_timeout` Serekan kehabisan waktu.
`wlan_hosted_network_reason_gp_denied` Operasi ini ditolak oleh kebijakan grup.
`wlan_hosted_network_reason_service_unavailable` Layanan LAN Nirkabel tidak berjalan.
`wlan_hosted_network_reason_device_change` Adaptor nirkabel yang digunakan oleh Jaringan Yang Dihosting nirkabel berubah.
`wlan_hosted_network_reason_properties_change` Properti Jaringan Yang Dihosting nirkabel berubah.
`wlan_hosted_network_reason_virtual_station_blocking_use` Stasiun virtual aktif dan memblokir operasi.
`wlan_hosted_network_reason_service_available_on_virtual_station` Layanan identik tersedia di stasiun virtual.

Keterangan

Jenis WLAN_HOSTED_NETWORK_REASON yang dijumlahkan adalah ekstensi untuk API nirkabel asli yang ditambahkan untuk mendukung Hosted Network nirkabel pada Windows 7 dan yang lebih baru.

WLAN_HOSTED_NETWORK_REASON menghitung kemungkinan alasan bahwa panggilan fungsi Jaringan Yang Dihosting nirkabel gagal atau alasan mengapa pemberitahuan Hosted Network nirkabel tertentu dibuat.

Pada Windows 7 dan yang lebih baru, sistem operasi menginstal perangkat virtual jika adaptor nirkabel yang mampu Jaringan Terhosting ada pada komputer. Perangkat virtual ini biasanya muncul di "Folder Koneksi Jaringan" sebagai 'Koneksi Jaringan Nirkabel 2' dengan Nama Perangkat 'adaptor Miniport Microsoft Virtual WiFi' jika komputer memiliki adaptor jaringan nirkabel tunggal. Perangkat virtual ini digunakan secara eksklusif untuk melakukan koneksi titik akses perangkat lunak (SoftAP) dan tidak ada dalam daftar yang dikembalikan oleh fungsi WlanEnumInterfaces . Masa pakai perangkat virtual ini terkait dengan adaptor nirkabel fisik. Jika adaptor nirkabel fisik dinonaktifkan, perangkat virtual ini juga akan dihapus.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	wlanapi.h (termasuk Wlanapi.h)