WlanEnumInterfaces (Compact 2013)
3/26/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.
- ppInterfaceList
Pointer to a WLAN_INTERFACE_INFO_LIST structure that contains the list of network adapter interfaces
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