Fungsi WlanSetProfilePosition (wlanapi.h)

Artikel
03/15/2023

Fungsi WlanSetProfilePosition mengatur posisi satu profil yang ditentukan dalam daftar preferensi.

Sintaks

DWORD WlanSetProfilePosition(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] LPCWSTR    strProfileName,
  [in] DWORD      dwPosition,
       PVOID      pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] pInterfaceGuid

GUID antarmuka.

[in] strProfileName

Nama profil. Nama profil peka huruf besar/kecil. String ini harus dihentikan NULL.

Windows XP dengan SP3 dan WIRELESS LAN API untuk Windows XP dengan SP2: Nama yang disediakan harus cocok dengan nama profil yang diturunkan secara otomatis dari SSID jaringan. Untuk profil jaringan infrastruktur, SSID harus disediakan untuk nama profil. Untuk profil jaringan ad hoc, nama yang disediakan harus SSID dari jaringan ad hoc diikuti oleh -adhoc.

[in] dwPosition

Menunjukkan posisi dalam daftar preferensi tempat profil harus digeser. 0 (nol) sesuai dengan profil pertama dalam daftar yang dikembalikan oleh fungsi WlanGetProfileList .

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai untuk mengubah posisi profil. Sebelum WlanSetProfilePosition melakukan operasi yang mengubah urutan relatif profil semua pengguna dalam daftar profil atau memindahkan profil semua pengguna ke posisi yang lebih rendah dalam daftar profil, WlanSetProfilePosition mengambil daftar kontrol akses diskresi (DACL) yang disimpan dengan objek wlan_secure_all_user_profiles_order . Jika DACL tidak berisi entri kontrol akses (ACE) yang memberikan izin WLAN_WRITE_ACCESS ke token akses utas panggilan, maka WlanSetProfilePosition mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandleNULL atau tidak valid, pInterfaceGuid adalah NULL, strProfileNameadalah NULL, atau pReserved bukan NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Posisi profil kebijakan grup tidak dapat diubah.

Secara default, hanya pengguna yang masuk sebagai anggota grup Administrator yang dapat mengubah posisi profil semua pengguna. Panggil WlanGetSecuritySettings untuk menentukan hak pengguna aktual yang diperlukan untuk mengubah posisi profil semua pengguna.

Untuk mengatur posisi profil di baris perintah, gunakan perintah netsh wlan set profileorder . 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: Profil ad hoc muncul setelah profil infrastruktur dalam daftar profil. Jika Anda mencoba memposisikan profil ad hoc sebelum profil infrastruktur menggunakan WlanSetProfilePosition, panggilan WlanSetProfilePosition akan berhasil tetapi layanan Konfigurasi Zero Nirkabel akan menyusun ulang daftar profil sehingga profil ad hoc diposisikan setelah semua profil jaringan infrastruktur.

Profil tamu, profil dengan autentikasi Wireless Provisioning Service (WPS), dan profil dengan autentikasi Wi-Fi Protected Access-None (WPA-None) tidak didukung. Profil apa pun yang muncul dalam daftar profil pilihan memiliki posisi tetap dalam daftar profil. Itu berarti posisinya tidak dapat diubah menggunakan WlanSetProfilePosition dan posisinya tidak terpengaruh oleh perubahan posisi profil lain.

Semua fungsi LAN nirkabel memerlukan GUID antarmuka untuk antarmuka nirkabel saat melakukan operasi profil. Ketika antarmuka nirkabel dihapus, statusnya dibersihkan dari Layanan LAN Nirkabel (WLANSVC) dan tidak ada operasi profil yang dimungkinkan.

Fungsi WlanSetProfilePosition dapat gagal dengan ERROR_INVALID_PARAMETER jika antarmuka nirkabel yang ditentukan dalam parameter pInterfaceGuid telah dihapus dari sistem (adaptor nirkabel USB yang telah dihapus, misalnya).

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui