WlanEnumInterfaces (Compact 7)

3/12/2014

This function enumerates all wireless network adapters that are currently plugged into the system.

Syntax

DWORD WINAPI WlanEnumInterfaces(
  __in        HANDLE hClientHandle,
  __reserved  PVOID pReserved,
  __out       PWLAN_INTERFACE_INFO_LIST* ppInterfaceList
);

Parameters

  • hClientHandle
    The client's session handle, obtained by a previous call to the WlanOpenHandle function
  • pReserved
    Reserved; set to NULL.

Return Values

Value Description

ERROR_SUCCESS

The function succeeds

ERROR_INVALID_PARAMETER

hClientHandle is NULL or invalid, pReserved is not NULL, or ppInterfaceList is not

ERROR_INVALID_HANDLE

The handle hClientHandle was not found in the handle table

RPC_STATUS

Various error codes

ERROR_NOT_ENOUGH_MEMORY

Could not allocate memory to create the client context

Remarks

This function allocates memory for the list of returned interfaces. The caller is responsible for freeing this memory by using the WlanFreeMemory function.

See Also

Reference

Native Wi-Fi Functions
WLAN_INTERFACE_INFO_LIST
WlanOpenHandle
WlanFreeMemory
Native Wi-Fi Reference