Función WlanGetInterfaceCapability (wlanapi.h)

La función WlanGetInterfaceCapability recupera las funcionalidades de una interfaz.

Sintaxis

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

Parámetros

[in] hClientHandle

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

[in] pInterfaceGuid

GUID de esta interfaz.

pReserved

Reservado para uso futuro. Debe establecerse en NULL.

[out] ppCapability

Estructura WLAN_INTERFACE_CAPABILITY que contiene información sobre las funcionalidades de la interfaz especificada.

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_INVALID_PARAMETER	hClientHandle es NULL o no válido, pInterfaceGuid es NULL, pReserved no es NULL o ppCapability es NULL.
ERROR_INVALID_HANDLE	El identificador hClientHandle no se encontró en la tabla de identificadores.
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 LAN inalámbrica API para Windows XP con el cliente SP2.
RPC_STATUS	Varios códigos de error.

Comentarios

El autor de la llamada es responsable de llamar a la función WlanFreeMemory para liberar la memoria asignada a ppCapability.

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