Fungsi WlanUIEditProfile (wlanapi.h)

Artikel
03/13/2024

Menampilkan antarmuka pengguna profil nirkabel (UI). UI ini digunakan untuk melihat dan mengedit setelan tingkat lanjut profil jaringan nirkabel.

Sintaks

DWORD WlanUIEditProfile(
  [in]  DWORD             dwClientVersion,
  [in]  LPCWSTR           wstrProfileName,
  [in]  GUID              *pInterfaceGuid,
  [in]  HWND              hWnd,
  [in]  WL_DISPLAY_PAGES  wlStartPage,
        PVOID             pReserved,
  [out] PWLAN_REASON_CODE pWlanReasonCode
);

Parameter

[in] dwClientVersion

Menentukan versi tertinggi WLAN API yang didukung klien. Nilai selain WLAN_UI_API_VERSION akan diabaikan.

[in] wstrProfileName

Berisi nama profil yang akan dilihat atau diedit. Nama profil peka huruf besar/kecil. String ini harus dihentikan NULL.

Profil yang disediakan harus ada pada antarmuka pInterfaceGuid. Itu berarti profil harus telah dibuat sebelumnya dan disimpan di penyimpanan profil dan bahwa profil harus valid untuk antarmuka yang disediakan.

[in] pInterfaceGuid

GUID antarmuka.

[in] hWnd

Handel jendela aplikasi yang meminta tampilan UI.

[in] wlStartPage

Nilai WL_DISPLAY_PAGES yang menentukan tab aktif saat kotak dialog UI muncul.

pReserved

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.

[out] pWlanReasonCode

Penunjuk ke nilai WLAN_REASON_CODE yang menunjukkan mengapa tampilan UI gagal.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Salah satu parameter yang disediakan tidak valid.
ERROR_NOT_SUPPORTED	Fungsi ini dipanggil dari platform yang tidak didukung. Nilai ini akan dikembalikan jika fungsi ini dipanggil dari Windows XP dengan SP3 atau WIRELESS LAN API untuk Windows XP dengan klien SP2.
RPC_STATUS	Berbagai kode kesalahan.

Keterangan

Jika WlanUIEditProfile mengembalikan ERROR_SUCCESS, setiap perubahan pada profil yang dibuat di UI akan disimpan di penyimpanan profil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h (termasuk Wlanapi.h)
Pustaka	Wlanui.lib
DLL	Wlanui.dll

Bagikan melalui