using System;
using System.Runtime.InteropServices;
using System.Net.NetworkInformation;
using System.Text;
using System.Diagnostics;
using System.ComponentModel;
namespace Tango.WiFi.Win32.Interop
{
// TODO: Separate the functions and the structs/enums. Many of the structs/enums should remain public
// (since they're reused in the OOP interfaces) -- the rest (including all P/Invoke function mappings)
// should become internal.
// All structures which native methods rely on should be kept in the Wlan class.
// Only change the layout of those structures if it matches the native API documentation.
// Some structures might have helper properties but adding or changing fields is prohibited.
// This class is not documented since all the documentation resides in the MSDN. The code
// documentation only covers details which concern interop users.
// Some identifier names were modified to correspond to .NET naming conventions
// but otherwise retain their native meaning.
///
/// Defines the Native Wifi API through P/Invoke interop.
///
///
/// This class is intended for internal use. Use the class instead.
///
internal static class WlanInterop
{
#region P/Invoke API
public const uint WLAN_CLIENT_VERSION_XP_SP2 = 1;
public const uint WLAN_CLIENT_VERSION_LONGHORN = 2;
[DllImport("wlanapi.dll")]
public static extern int WlanOpenHandle(
[In] UInt32 clientVersion,
[In, Out] IntPtr pReserved,
[Out] out UInt32 negotiatedVersion,
[Out] out IntPtr clientHandle);
[DllImport("wlanapi.dll")]
public static extern int WlanCloseHandle(
[In] IntPtr clientHandle,
[In, Out] IntPtr pReserved);
[DllImport("wlanapi.dll")]
public static extern int WlanEnumInterfaces(
[In] IntPtr clientHandle,
[In, Out] IntPtr pReserved,
[Out] out IntPtr ppInterfaceList);
[DllImport("wlanapi.dll")]
public static extern int WlanQueryInterface(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] WlanIntfOpcode opCode,
[In, Out] IntPtr pReserved,
[Out] out int dataSize,
[Out] out IntPtr ppData,
[Out] out WlanOpcodeValueType wlanOpcodeValueType);
[DllImport("wlanapi.dll")]
public static extern int WlanSetInterface(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] WlanIntfOpcode opCode,
[In] uint dataSize,
[In] IntPtr pData,
[In, Out] IntPtr pReserved);
/// Not supported on Windows XP SP2: must be a null reference.
/// Not supported on Windows XP SP2: must be a null reference.
[DllImport("wlanapi.dll")]
public static extern int WlanScan(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] IntPtr pDot11Ssid,
[In] IntPtr pIeData,
[In, Out] IntPtr pReserved);
[DllImport("wlanapi.dll")]
public static extern int WlanGetAvailableNetworkList(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] WlanGetAvailableNetworkFlags flags,
[In, Out] IntPtr reservedPtr,
[Out] out IntPtr availableNetworkListPtr);
[DllImport("wlanapi.dll")]
public static extern int WlanSetProfile(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] WlanProfileFlags flags,
[In, MarshalAs(UnmanagedType.LPWStr)] string profileXml,
[In, Optional, MarshalAs(UnmanagedType.LPWStr)] string allUserProfileSecurity,
[In] bool overwrite,
[In] IntPtr pReserved,
[Out] out WlanReasonCode reasonCode);
/// Not supported on Windows XP SP2: must be a null reference.
[DllImport("wlanapi.dll")]
public static extern int WlanGetProfile(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In, MarshalAs(UnmanagedType.LPWStr)] string profileName,
[In] IntPtr pReserved,
[Out] out IntPtr profileXml,
[Out, Optional] out WlanProfileFlags flags,
[Out, Optional] out WlanAccess grantedAccess);
[DllImport("wlanapi.dll")]
public static extern int WlanGetProfileList(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] IntPtr pReserved,
[Out] out IntPtr profileList
);
[DllImport("wlanapi.dll")]
public static extern void WlanFreeMemory(IntPtr pMemory);
[DllImport("wlanapi.dll")]
public static extern int WlanReasonCodeToString(
[In] WlanReasonCode reasonCode,
[In] int bufferSize,
[In, Out] StringBuilder stringBuffer,
IntPtr pReserved
);
///
/// Defines the callback function which accepts WLAN notifications.
///
public delegate void WlanNotificationCallbackDelegate(ref WlanNotificationData notificationData, IntPtr context);
[DllImport("wlanapi.dll")]
public static extern int WlanRegisterNotification(
[In] IntPtr clientHandle,
[In] WlanNotificationSource notifSource,
[In] bool ignoreDuplicate,
[In] WlanNotificationCallbackDelegate funcCallback,
[In] IntPtr callbackContext,
[In] IntPtr reserved,
[Out] out WlanNotificationSource prevNotifSource);
[DllImport("wlanapi.dll")]
public static extern int WlanConnect(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] ref WlanConnectionParameters connectionParameters,
IntPtr pReserved);
[DllImport("wlanapi.dll")]
public static extern int WlanDeleteProfile(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In, MarshalAs(UnmanagedType.LPWStr)] string profileName,
IntPtr reservedPtr
);
[DllImport("wlanapi.dll")]
public static extern int WlanDisconnect(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
IntPtr pReserved);
[DllImport("wlanapi.dll")]
public static extern int WlanGetNetworkBssList(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In] IntPtr dot11SsidInt,
[In] Dot11BssType dot11BssType,
[In] bool securityEnabled,
IntPtr reservedPtr,
[Out] out IntPtr wlanBssList
);
/*
DWORD WlanSetProfileEapUserData(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ LPCWSTR strProfileName,
_In_ EAP_METHOD_TYPE eapType,
_In_ DWORD dwFlags,
_In_ DWORD dwEapUserDataSize,
_In_ const LPBYTE pbEapUserData,
_Reserved_ PVOID pReserved
);
*/
// Link: http://msdn.microsoft.com/en-us/library/windows/desktop/ms706797(v=vs.85).aspx
/*[DllImport("wlanapi.dll")]
public static extern int WlanSetProfileEapUserData(
[In] IntPtr clientHandle,
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid,
[In, MarshalAs(UnmanagedType.LPWStr)] string profileName,
[In] EapMethodType eapType, // EAP_METHOD_TYPE
[In] SetEapUserDataMode dwFlags,
[In] uint dwEapUserDataSize,
[In] byte[] pbEapUserData, // Not sure if this is correct, const LPBYTE pbEapUserData,
IntPtr reservedPtr
);*/
/*
DWORD WlanSetProfileEapXmlUserData(
_In_ HANDLE hClientHandle,
_In_ const GUID *pInterfaceGuid,
_In_ LPCWSTR strProfileName,
_In_ DWORD dwFlags,
_In_ LPCWSTR strEapXmlUserData,
_Reserved_ PVOID pReserved
);
*/
[DllImport("wlanapi.dll")]
public static extern int WlanSetProfileEapXmlUserData(
[In] IntPtr clientHandle, // The client's session handle, obtained by a previous call to the WlanOpenHandle function.
[In, MarshalAs(UnmanagedType.LPStruct)] Guid interfaceGuid, // The GUID of the interface.
[In, MarshalAs(UnmanagedType.LPWStr)] string profileName, // The name of the profile associated with the EAP user data. Profile names are case-sensitive. This string must be NULL-terminated.
[In] SetEapUserDataMode dwFlags, // A set of flags that modify the behavior of the function.
[In, MarshalAs(UnmanagedType.LPWStr)] string userDataXML, // A pointer to XML data used to set the user credentials, The XML data must be based on the EAPHost User Credentials schema. To view sample user credential XML data, see EAPHost User Properties: http://msdn.microsoft.com/en-us/library/windows/desktop/bb204765(v=vs.85).aspx
IntPtr reservedPtr
);
#endregion
///
/// Helper method to wrap calls to Native WiFi API methods.
/// If the method falls, throws an exception containing the error code.
///
/// The error code.
[DebuggerStepThrough]
internal static void ThrowIfError(int win32ErrorCode)
{
if (win32ErrorCode != 0)
throw new Win32Exception(win32ErrorCode);
}
}
}