Fungsi WlanIhvControl (wlanapi.h)

Artikel
03/09/2024

Fungsi WlanIhvControl menyediakan mekanisme untuk kontrol vendor perangkat keras independen (IHV) driver atau layanan WLAN.

Sintaks

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

Parameter

[in] hClientHandle

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

[in] pInterfaceGuid

GUID antarmuka.

[in] Type

Struktur WLAN_IHV_CONTROL_TYPE yang menentukan jenis perangkat lunak yang dilewati oleh fungsi kontrol IHV.

[in] dwInBufferSize

Ukuran, dalam byte, dari buffer input.

[in] pInBuffer

Buffer generik untuk input antarmuka driver atau layanan.

[in] dwOutBufferSize

Ukuran, dalam byte, dari buffer output.

[in, out, optional] pOutBuffer

Buffer generik untuk output antarmuka driver atau layanan.

[out] pdwBytesReturned

Jumlah byte yang dikembalikan.

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 melakukan operasi ini. Ketika dipanggil, WlanIhvControl mengambil daftar kontrol akses diskresi (DACL) yang disimpan dengan objek wlan_secure_ihv_control . Jika DACL tidak berisi entri kontrol akses (ACE) yang memberikan izin WLAN_WRITE_ACCESS ke token akses utas panggilan, maka WlanIhvControl mengembalikan ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandleNULL atau tidak valid, pInterfaceGuid adalah NULL, atau pdwBytesReturned 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.

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

WLAN_IHV_CONTROL_TYPE

Bagikan melalui