Fungsi WlanSetProfileList (wlanapi.h)

Artikel
03/04/2024

Fungsi WlanSetProfileList mengatur urutan preferensi profil untuk antarmuka tertentu.

Sintaks

DWORD WlanSetProfileList(
  [in] HANDLE     hClientHandle,
  [in] const GUID *pInterfaceGuid,
  [in] DWORD      dwItems,
  [in] LPCWSTR    *strProfileNames,
       PVOID      pReserved
);

Parameter

[in] hClientHandle

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

[in] pInterfaceGuid

GUID antarmuka.

[in] dwItems

Jumlah profil dalam parameter strProfileNames .

[in] strProfileNames

Nama profil dalam urutan yang diinginkan. 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 berasal 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.

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_ACCESS_DENIED	Pemanggil tidak memiliki izin yang memadai untuk mengubah daftar profil. Sebelum WlanSetProfileList 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, WlanSetProfileList 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 WlanSetProfileList mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
ERROR_INVALID_PARAMETER	Salah satu kondisi berikut terjadi: hClientHandleadalah NULL atau tidak valid. pInterfaceGuid adalah NULL. dwItems adalah 0. strProfileNames adalah NULL. Nama profil yang sama muncul lebih dari sekali di strProfileNames. pReserved bukan NULL.
ERROR_NOT_FOUND	strProfileNames berisi nama profil yang tidak ada di penyimpanan profil.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Fungsi WlanSetProfileList mengatur urutan preferensi profil LAN nirkabel untuk antarmuka nirkabel tertentu.

Profil dalam daftar harus cocok satu-ke-satu dengan profil saat ini yang dikembalikan oleh fungsi WlanGetProfileList . Posisi profil kebijakan grup tidak dapat diubah.

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 WlanSetProfileList 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

WlanGetProfile

WlanGetProfileList

WlanSetProfile

Bagikan melalui