Fungsi WlanSaveTemporaryProfile (wlanapi.h)

Artikel
08/28/2023

Fungsi WlanSaveTemporaryProfile menyimpan profil sementara ke penyimpanan profil.

Sintaks

DWORD WlanSaveTemporaryProfile(
  [in]           HANDLE     hClientHandle,
  [in]           const GUID *pInterfaceGuid,
  [in]           LPCWSTR    strProfileName,
  [in, optional] LPCWSTR    strAllUserProfileSecurity,
  [in]           DWORD      dwFlags,
  [in]           BOOL       bOverWrite,
                 PVOID      pReserved
);

Parameter

[in] hClientHandle

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

[in] pInterfaceGuid

GUID antarmuka.

[in] strProfileName

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

[in, optional] strAllUserProfileSecurity

Mengatur string deskriptor keamanan pada profil semua pengguna. Secara default, untuk profil semua pengguna baru, semua pengguna memiliki akses tulis di profil. Untuk informasi selengkapnya tentang izin profil, lihat bagian Keterangan.

Jika dwFlags diatur ke WLAN_PROFILE_USER, parameter ini diabaikan.

Jika parameter ini diatur ke NULL untuk profil semua pengguna, izin default akan digunakan.

Jika parameter ini bukan NULL untuk profil semua pengguna, string deskriptor keamanan yang terkait dengan profil dibuat atau dimodifikasi setelah objek deskriptor keamanan dibuat dan diurai sebagai string.

[in] dwFlags

Menentukan bendera yang akan diatur pada profil. Bendera dapat digabungkan.

Nilai	Makna
0	Profil adalah profil semua pengguna.
WLAN_PROFILE_USER 0x00000002	Profil adalah profil per pengguna.
WLAN_PROFILE_CONNECTION_MODE_SET_BY_CLIENT 0x00010000	Profil dibuat oleh klien.
WLAN_PROFILE_CONNECTION_MODE_AUTO 0x00020000	Profil dibuat oleh modul konfigurasi otomatis.

[in] bOverWrite

Menentukan apakah profil ini menimpa profil yang ada. Jika parameter ini FALSE dan profil sudah ada, profil yang ada tidak akan ditimpa dan kesalahan akan dikembalikan.

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. pReserved bukan NULL. dwFlags tidak diatur ke kombinasi satu atau beberapa nilai yang ditentukan dalam tabel di atas. dwFlags diatur ke WLAN_PROFILE_CONNECTION_MODE_AUTO dan strProfileName adalah NULL.
ERROR_INVALID_HANDLE	Handel hClientHandle tidak ditemukan dalam tabel handel.
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.
ERROR_INVALID_STATE	Antarmuka saat ini tidak tersambung menggunakan profil sementara.

Keterangan

Profil sementara adalah profil yang diteruskan ke WlanConnect atau dihasilkan oleh mesin penemuan. Sambungan jaringan dapat dibuat menggunakan profil sementara. Menggunakan API ini menyimpan profil sementara dan data pengguna terkait ke penyimpanan profil.

Profil baru ditambahkan di bagian atas daftar setelah profil kebijakan grup. Posisi profil dalam daftar tidak diubah jika profil yang ada ditimpa.

Profil semua pengguna memiliki tiga izin terkait: baca, tulis, dan jalankan. Jika pengguna memiliki akses baca, pengguna dapat melihat izin profil. Jika pengguna telah menjalankan akses, pengguna memiliki akses baca dan pengguna juga dapat terhubung dan memutuskan sambungan dari jaringan menggunakan profil. Jika pengguna memiliki akses tulis, pengguna telah menjalankan akses dan pengguna juga dapat mengubah dan menghapus izin yang terkait dengan profil.

Berikut ini menjelaskan prosedur untuk membuat objek deskriptor keamanan dan mengurainya sebagai string.

Panggil InitializeSecurityDescriptor untuk membuat deskriptor keamanan dalam memori.
Panggil SetSecurityDescriptorOwner.
Panggil InitializeAcl untuk membuat daftar kontrol akses diskresi (DACL) dalam memori.
Panggil AddAccessAllowedAce atau AddAccessDeniedAce untuk menambahkan entri kontrol akses (ACE) ke DACL. Atur parameter AccessMask ke salah satu kombinasi bitwise OR berikut ini sebagaimana merujuk:
- WLAN_READ_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS
- WLAN_READ_ACCESS | WLAN_EXECUTE_ACCESS | WLAN_WRITE_ACCESS
Panggil SetSecurityDescriptorDacl untuk menambahkan DACL ke deskriptor keamanan.
Panggil ConvertSecurityDescriptorToStringSecurityDescriptor untuk mengonversi deskriptor menjadi string.

String yang dikembalikan oleh ConvertSecurityDescriptorToStringSecurityDescriptor kemudian dapat digunakan sebagai nilai parameter strAllUserProfileSecurity saat memanggil WlanSaveTemporaryProfile.

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	Wlanapi.lib
DLL	Wlanapi.dll

Lihat juga

Izin API Wifi Asli

Bagikan melalui