Export (0) Print
Expand All
Expand Minimize

WlanIhvControl function

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

Syntax


DWORD WINAPI WlanIhvControl(
  _In_         HANDLE hClientHandle,
  _In_         const GUID *pInterfaceGuid,
  _In_         WLAN_IHV_CONTROL_TYPE Type,
  _In_         DWORD dwInBufferSize,
  _In_         PVOID pInBuffer,
  _In_         DWORD dwOutBufferSize,
  _Inout_opt_  PVOID pOutBuffer,
  _Out_        PDWORD pdwBytesReturned
);

Parameters

hClientHandle [in]

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

pInterfaceGuid [in]

The GUID of the interface.

Type [in]

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

dwInBufferSize [in]

The size, in bytes, of the input buffer.

pInBuffer [in]

A generic buffer for driver or service interface input.

dwOutBufferSize [in]

The size, in bytes, of the output buffer.

pOutBuffer [in, out, optional]

A generic buffer for driver or service interface output.

pdwBytesReturned [out]

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 codeDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wlanapi.h (include Wlanapi.h)

Library

Wlanapi.lib

DLL

Wlanapi.dll

See also

WLAN_IHV_CONTROL_TYPE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft