Función WlanIhvControl (wlanapi.h)

La función WlanIhvControl proporciona un mecanismo para el control independiente del proveedor de hardware (IHV) de controladores o servicios WLAN.

Sintaxis

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

Parámetros

[in] hClientHandle

Identificador de sesión del cliente, obtenido por una llamada anterior a la función WlanOpenHandle .

[in] pInterfaceGuid

GUID de la interfaz.

[in] Type

Estructura WLAN_IHV_CONTROL_TYPE que especifica el tipo de software omitido por la función de control IHV.

[in] dwInBufferSize

Tamaño, en bytes, del búfer de entrada.

[in] pInBuffer

Un búfer genérico para la entrada del controlador o de la interfaz de servicio.

[in] dwOutBufferSize

Tamaño, en bytes, del búfer de salida.

[in, out, optional] pOutBuffer

Un búfer genérico para la salida del controlador o de la interfaz de servicio.

[out] pdwBytesReturned

Número de bytes devueltos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de retorno.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El autor de la llamada no tiene permisos suficientes para realizar esta operación. Cuando se llama a , WlanIhvControl recupera la lista de control de acceso discrecional (DACL) almacenada con el objeto wlan_secure_ihv_control . Si la DACL no contiene una entrada de control de acceso (ACE) que concede WLAN_WRITE_ACCESS permiso al token de acceso del subproceso de llamada, WlanIhvControl devuelve ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle es NULL o no es válido, pInterfaceGuid es NULL o pdwBytesReturned es NULL.
ERROR_INVALID_HANDLE	No se encontró el identificador hClientHandle en la tabla handle.
ERROR_NOT_SUPPORTED	Se llamó a esta función desde una plataforma no admitida. Este valor se devolverá si se llamó a esta función desde un Windows XP con SP3 o la API de LAN inalámbrica para Windows XP con el cliente SP2.
RPC_STATUS	Varios códigos de error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wlanapi.h (incluya Wlanapi.h)
Library	Wlanapi.lib
Archivo DLL	Wlanapi.dll

Consulte también

WLAN_IHV_CONTROL_TYPE