WlanIhvControl function (wlanapi.h)

The WlanIhvControl function provides a mechanism for independent hardware vendor (IHV) control of WLAN drivers or services.


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


[in] hClientHandle

The client's session handle, obtained by a previous call to the WlanOpenHandle function.

[in] pInterfaceGuid

The GUID of the interface.

[in] Type

A WLAN_IHV_CONTROL_TYPE structure that specifies the type of software bypassed by the IHV control function.

[in] dwInBufferSize

The size, in bytes, of the input buffer.

[in] pInBuffer

A generic buffer for driver or service interface input.

[in] dwOutBufferSize

The size, in bytes, of the output buffer.

[in, out, optional] pOutBuffer

A generic buffer for driver or service interface output.

[out] pdwBytesReturned

The number of bytes returned.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value may be one of the following return codes.

Return code Description
The caller does not have sufficient permissions to perform this operation. When called, WlanIhvControl retrieves the discretionary access control list (DACL) stored with the wlan_secure_ihv_control object. If the DACL does not contain an access control entry (ACE) that grants WLAN_WRITE_ACCESS permission to the access token of the calling thread, then WlanIhvControl returns ERROR_ACCESS_DENIED.
hClientHandle is NULL or invalid, pInterfaceGuid is NULL, or pdwBytesReturned is NULL.
The handle hClientHandle was not found in the handle table.
This function was called from an unsupported platform. This value will be returned if this function was called from a Windows XP with SP3 or Wireless LAN API for Windows XP with SP2 client.
Various error codes.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wlanapi.h (include Wlanapi.h)
Library Wlanapi.lib
DLL Wlanapi.dll

See also