Edit

Share via

WlanIhvControl function (wlanapi.h)

  • Article
  • 02/22/2024

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

Syntax

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
);

Parameters

[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
ERROR_ACCESS_DENIED
 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.
ERROR_INVALID_PARAMETER
 hClientHandle is NULL or invalid, pInterfaceGuid is NULL, or pdwBytesReturned is NULL.
ERROR_INVALID_HANDLE
 The handle hClientHandle was not found in the handle table.
ERROR_NOT_SUPPORTED
 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.
RPC_STATUS
 Various error codes.

Requirements

Requirement Value
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

WLAN_IHV_CONTROL_TYPE

Additional resources