wine/dlls/wlanapi/main.c
Bruno Jesus 0cbcb71be9 wlanapi: Add some usage information.
Signed-off-by: Bruno Jesus <00cpxxx@gmail.com>
Signed-off-by: Alexandre Julliard <julliard@winehq.org>
2017-02-13 18:50:13 +01:00

210 lines
5.8 KiB
C

/*
* Copyright 2010 Ričardas Barkauskas
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
*/
/* How does this DLL work?
* This DLL is used to probe and configure wireless access points using the
* available wireless interfaces. Most functions are tied to a handle that is
* first obtained by calling WlanOpenHandle. Usually it is followed by a call
* to WlanEnumInterfaces and then for each interface a WlanScan call is made.
* WlanScan starts a parallel access point discovery that delivers the ready
* response through the callback registered by WlanRegisterNotification. After
* that the program calls WlanGetAvailableNetworkList or WlanGetNetworkBssList.
*/
#include "config.h"
#include <stdarg.h>
#include "windef.h"
#include "winbase.h"
#include "wine/debug.h"
#include "wlanapi.h"
WINE_DEFAULT_DEBUG_CHANNEL(wlanapi);
#define WLAN_MAGIC 0x574c414e /* WLAN */
static struct wine_wlan
{
DWORD magic, cli_version;
} handle_table[16];
static struct wine_wlan* handle_index(HANDLE handle)
{
ULONG_PTR i = (ULONG_PTR)handle - 1;
if (i < sizeof(handle_table) / sizeof(handle_table[0]) && handle_table[i].magic == WLAN_MAGIC)
return &handle_table[i];
return NULL;
}
static HANDLE handle_new(struct wine_wlan **entry)
{
ULONG_PTR i;
for (i = 0; i < sizeof(handle_table) / sizeof(handle_table[0]); i++)
{
if (handle_table[i].magic == 0)
{
*entry = &handle_table[i];
return (HANDLE)(i + 1);
}
}
return NULL;
}
DWORD WINAPI WlanEnumInterfaces(HANDLE handle, void *reserved, WLAN_INTERFACE_INFO_LIST **interface_list)
{
struct wine_wlan *wlan;
WLAN_INTERFACE_INFO_LIST *ret_list;
FIXME("(%p, %p, %p) semi-stub\n", handle, reserved, interface_list);
if (!handle || reserved || !interface_list)
return ERROR_INVALID_PARAMETER;
wlan = handle_index(handle);
if (!wlan)
return ERROR_INVALID_HANDLE;
ret_list = WlanAllocateMemory(sizeof(WLAN_INTERFACE_INFO_LIST));
if (!ret_list)
return ERROR_NOT_ENOUGH_MEMORY;
memset(&ret_list->InterfaceInfo[0], 0, sizeof(WLAN_INTERFACE_INFO));
ret_list->dwNumberOfItems = 0;
ret_list->dwIndex = 0; /* unused in this function */
*interface_list = ret_list;
return ERROR_SUCCESS;
}
DWORD WINAPI WlanCloseHandle(HANDLE handle, void *reserved)
{
struct wine_wlan *wlan;
TRACE("(%p, %p)\n", handle, reserved);
if (!handle || reserved)
return ERROR_INVALID_PARAMETER;
wlan = handle_index(handle);
if (!wlan)
return ERROR_INVALID_HANDLE;
wlan->magic = 0;
return ERROR_SUCCESS;
}
DWORD WINAPI WlanOpenHandle(DWORD client_version, void *reserved, DWORD *negotiated_version, HANDLE *handle)
{
struct wine_wlan *wlan;
HANDLE ret_handle;
TRACE("(%u, %p, %p, %p)\n", client_version, reserved, negotiated_version, handle);
if (reserved || !negotiated_version || !handle)
return ERROR_INVALID_PARAMETER;
if (client_version != 1 && client_version != 2)
return ERROR_NOT_SUPPORTED;
ret_handle = handle_new(&wlan);
if (!ret_handle)
return ERROR_REMOTE_SESSION_LIMIT_EXCEEDED;
wlan->magic = WLAN_MAGIC;
wlan->cli_version = *negotiated_version = client_version;
*handle = ret_handle;
return ERROR_SUCCESS;
}
DWORD WINAPI WlanScan(HANDLE handle, const GUID *guid, const DOT11_SSID *ssid,
const WLAN_RAW_DATA *raw, void *reserved)
{
FIXME("(%p, %s, %p, %p, %p) stub\n",
handle, wine_dbgstr_guid(guid), ssid, raw, reserved);
return ERROR_CALL_NOT_IMPLEMENTED;
}
DWORD WINAPI WlanRegisterNotification(HANDLE handle, DWORD notify_source, BOOL ignore_dup,
WLAN_NOTIFICATION_CALLBACK callback, void *context,
void *reserved, DWORD *notify_prev)
{
FIXME("(%p, %d, %d, %p, %p, %p, %p) stub\n",
handle, notify_source, ignore_dup, callback, context, reserved, notify_prev);
return ERROR_CALL_NOT_IMPLEMENTED;
}
DWORD WINAPI WlanGetAvailableNetworkList(HANDLE handle, const GUID *guid, DWORD flags,
void *reserved, WLAN_AVAILABLE_NETWORK_LIST **network_list)
{
FIXME("(%p, %s, 0x%x, %p, %p) stub\n",
handle, wine_dbgstr_guid(guid), flags, reserved, network_list);
return ERROR_CALL_NOT_IMPLEMENTED;
}
void WINAPI WlanFreeMemory(void *ptr)
{
TRACE("(%p)\n", ptr);
HeapFree(GetProcessHeap(), 0, ptr);
}
void *WINAPI WlanAllocateMemory(DWORD size)
{
void *ret;
TRACE("(%d)\n", size);
if (!size)
{
SetLastError(ERROR_INVALID_PARAMETER);
return NULL;
}
ret = HeapAlloc(GetProcessHeap(), 0, size);
if (!ret)
SetLastError(ERROR_NOT_ENOUGH_MEMORY);
return ret;
}
BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD reason, void *reserved)
{
TRACE("(0x%p, %u, %p)\n", hinstDLL, reason, reserved);
switch (reason)
{
case DLL_WINE_PREATTACH:
return FALSE; /* prefer native version */
case DLL_PROCESS_ATTACH:
DisableThreadLibraryCalls(hinstDLL);
break;
}
return TRUE;
}