Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
WlanIhvControl
Collapse the table of content
Expand the table of content

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:
© 2015 Microsoft