Fungsi WlanConnect (wlanapi.h)

  • Artikel

Fungsi WlanConnect mencoba menyambungkan ke jaringan tertentu.

Sintaks

DWORD WlanConnect(
  [in] HANDLE                            hClientHandle,
  [in] const GUID                        *pInterfaceGuid,
  [in] const PWLAN_CONNECTION_PARAMETERS pConnectionParameters,
       PVOID                             pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, dikembalikan oleh panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] pInterfaceGuid

GUID antarmuka yang digunakan untuk koneksi.

[in] pConnectionParameters

Penunjuk ke struktur WLAN_CONNECTION_PARAMETERS yang menentukan jenis koneksi, mode, profil jaringan, SSID yang mengidentifikasi jaringan, dan parameter lainnya.

Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2: Ada beberapa batasan pada anggota WLAN_CONNECTION_PARAMETERS . Ini berarti bahwa struktur yang valid untuk Windows Server 2008 dan Windows Vista mungkin tidak valid untuk Windows XP dengan SP3 atau Wireless LAN API untuk Windows XP dengan SP2. Untuk daftar batasan, lihat WLAN_CONNECTION_PARAMETERS.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin merupakan salah satu kode pengembalian berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
 Salah satu kondisi berikut terjadi:
  • hClientHandleadalah NULL atau tidak valid.
  • pInterfaceGuid adalah NULL.
  • pConnectionParameters adalah NULL.
  • Anggota dwFlags dari struktur yang diarahkan oleh pConnectionParameters tidak diatur ke salah satu nilai yang ditentukan pada halaman WLAN_CONNECTION_PARAMETERS .
  • Anggota wlanConnectionMode dari struktur yang diarahkan oleh pConnectionParameters diatur ke wlan_connection_mode_discovery_secure atau wlan_connection_mode_discovery_unsecure, dan anggota pDot11Ssid dari struktur yang sama adalah NULL.
  • Anggota wlanConnectionMode dari struktur yang diarahkan oleh pConnectionParameters diatur ke wlan_connection_mode_discovery_secure atau wlan_connection_mode_discovery_unsecure, dan anggota dot11BssType dari struktur yang sama diatur ke dot11_BSS_type_any.
  • Anggota wlanConnectionMode dari struktur yang diarahkan oleh pConnectionParameters diatur ke wlan_connection_mode_profile, dan anggota strProfile dari struktur yang sama adalah NULL atau panjang profil melebihi WLAN_MAX_NAME_LENGTH.
  • Anggota wlanConnectionMode dari struktur yang diarahkan oleh pConnectionParameters diatur ke wlan_connection_mode_profile, dan anggota strProfile dari struktur yang sama adalah NULL atau panjang profil adalah nol.
  • Anggota wlanConnectionMode dari struktur yang diarahkan oleh pConnectionParameters diatur ke wlan_connection_mode_invalid atau wlan_connection_mode_auto.
  • Anggota dot11BssType dari struktur yang diarahkan oleh pConnectionParameters diatur ke dot11_BSS_type_infrastructure, dan anggota dwFlags dari struktur yang sama diatur ke WLAN_CONNECTION_ADHOC_JOIN_ONLY.
  • Anggota dot11BssType dari struktur yang diarahkan oleh pConnectionParameters diatur ke dot11_BSS_type_independent, dan anggota dwFlags dari struktur yang sama diatur ke WLAN_CONNECTION_HIDDEN_NETWORK.
  • Anggota dwFlags dari struktur yang diarahkan oleh pConnectionParameters diatur ke WLAN_CONNECTION_IGNORE_PRIVACY_BIT, dan anggota wlanConnectionMode dari struktur yang sama tidak diatur ke wlan_connection_mode_temporary_profile atau anggota dot11BssType dari struktur yang sama diatur ke dot11_BSS_type_independent.
ERROR_INVALID_HANDLE
 Handel hClientHandle tidak ditemukan dalam tabel handel.
RPC_STATUS
 Berbagai kode kesalahan.
ERROR_ACCESS_DENIED
 Pemanggil tidak memiliki izin yang memadai.

Keterangan

Fungsi WlanConnect segera kembali. Untuk diberi tahu ketika koneksi dibuat atau ketika tidak ada koneksi lebih lanjut yang akan dicoba, klien harus mendaftar untuk pemberitahuan dengan memanggil WlanRegisterNotification.

Anggota strProfile dari struktur WLAN_CONNECTION_PARAMETERS yang diarahkan oleh pConnectionParameters menentukan profil yang akan digunakan untuk koneksi. Jika profil ini adalah profil semua pengguna, pemanggil WlanConnect harus memiliki akses eksekusi pada profil. Jika tidak, panggilan WlanConnect akan gagal dengan nilai yang dikembalikan ERROR_ACCESS_DENIED. Izin pada profil semua pengguna dibuat saat profil dibuat atau disimpan menggunakan WlanSetProfile atau WlanSaveTemporaryProfile.

Untuk melakukan operasi koneksi di baris perintah, gunakan perintah netsh wlan connect . Untuk informasi selengkapnya, lihat Perintah Netsh untuk Jaringan Area Lokal Nirkabel (wlan).

Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2: Anda hanya dapat menggunakan WlanConnect untuk menyambungkan ke jaringan pada daftar jaringan pilihan. Untuk menambahkan jaringan ke daftar jaringan pilihan, panggil WlanSetProfile.

Persyaratan

   
Klien minimum yang didukung Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header wlanapi.h (termasuk Wlanapi.h)
Pustaka Wlanapi.lib
DLL Wlanapi.dll
Redistribusi API LAN Nirkabel untuk Windows XP dengan SP2

Lihat juga

WLAN_CONNECTION_PARAMETERS

WlanDisconnect