WinCompat.cxx

Go to the documentation of this file.

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
 
#include <Winsock2.h>
#include <Iphlpapi.h>
#include <tchar.h>
#include <winternl.h>
#pragma comment(lib, "ntdll.lib")
 
#include "rutil/GenericIPAddress.hxx"
#include "rutil/WinCompat.hxx"
#include "rutil/DnsUtil.hxx"
#include "rutil/Log.hxx"
#include "rutil/Logger.hxx"
#include "rutil/WinLeakCheck.hxx"
 
#define RESIPROCATE_SUBSYSTEM Subsystem::TRANSPORT
 
 
static char* ConvertLPWSTRToLPSTR(LPWSTR lpwszStrIn)
{
   LPSTR pszOut = NULL;
   if (lpwszStrIn != NULL)
   {
      int nInputStrLen = (int)wcslen(lpwszStrIn);
 
      // Double NULL Termination
      int nOutputStrLen = WideCharToMultiByte (CP_ACP, 0, lpwszStrIn, nInputStrLen, NULL, 0, 0, 0) + 2;
      pszOut = new char [nOutputStrLen];
 
      if (pszOut)
      {
         memset (pszOut, 0x00, nOutputStrLen);
         WideCharToMultiByte(CP_ACP, 0, lpwszStrIn, nInputStrLen, pszOut, nOutputStrLen, 0, 0);
      }
   }
   return pszOut;
}
 
using namespace resip;
 
class WinCompatInstanceCleaner
{
public:
    ~WinCompatInstanceCleaner() { WinCompat::destroyInstance(); }
} winCompatInstanceCleaner;
 
WinCompat::Exception::Exception(const Data& msg, const Data& file, const int line) :
   BaseException(msg,file,line)
{
}
 
extern "C" NTSTATUS NTAPI RtlGetVersion(PRTL_OSVERSIONINFOW lpVersionInformation);
WinCompat::Version
WinCompat::getVersion()
{
#ifdef UNDER_CE
   return WinCompat::WindowsUnknown;
#endif
 
   // RtlGetVersion always returns the true OS version regardless of manifest,
   // unlike GetVersionEx which lies on Windows 10+ without a compatibility manifest.
   OSVERSIONINFOEXW osvi = { sizeof(osvi) };
   if (RtlGetVersion((PRTL_OSVERSIONINFOW)&osvi) != 0)
   {
      return WinCompat::WindowsUnknown;
   }
 
   // Only Windows NT platform is relevant now (Win9x/ME are long dead)
   if (osvi.dwPlatformId != VER_PLATFORM_WIN32_NT)
   {
      return WinCompat::WindowsUnknown;
   }
 
   const DWORD major = osvi.dwMajorVersion;
   const DWORD minor = osvi.dwMinorVersion;
   const WORD  type = osvi.wProductType;  // VER_NT_WORKSTATION or server
 
   if (major == 10 && minor == 0)
   {
      if (osvi.dwBuildNumber >= 22000)
      {
         return (type == VER_NT_WORKSTATION) ? WinCompat::Windows11
            : WinCompat::WindowsServer2022;
      }
      return (type == VER_NT_WORKSTATION) ? WinCompat::Windows10
         : WinCompat::WindowsServer2016;
   }
   else if (major == 6 && minor == 3)
   {
      return (type == VER_NT_WORKSTATION) ? WinCompat::Windows81
         : WinCompat::WindowsServer2012R2;
   }
   else if (major == 6 && minor == 2)
   {
      return (type == VER_NT_WORKSTATION) ? WinCompat::Windows8
         : WinCompat::WindowsServer2012;
   }
   else if (major == 6 && minor == 1)
   {
      return (type == VER_NT_WORKSTATION) ? WinCompat::Windows7
         : WinCompat::WindowsServer2008R2;
   }
   else if (major == 6 && minor == 0)
   {
      return (type == VER_NT_WORKSTATION) ? WinCompat::WindowsVista
         : WinCompat::WindowsServer2008;
   }
   else if (major == 5 && minor == 2) { return WinCompat::Windows2003Server; }
   else if (major == 5 && minor == 1) { return WinCompat::WindowsXP; }
   else if (major == 5 && minor == 0) { return WinCompat::Windows2000; }
   else if (major <= 4) { return WinCompat::WindowsNT; }
 
   return WinCompat::WindowsUnknown;
}
 
 
WinCompat* WinCompat::mInstance = 0;
 
 
static Mutex WinComaptInstanceMutex;
WinCompat *
WinCompat::instance()
{
   if (!mInstance)
   {
      Lock lock(WinComaptInstanceMutex);
      if (!mInstance)
      {
         mInstance = new WinCompat();
      }
   }
   return mInstance;
}
 
 
WinCompat::WinCompat() :
   getBestInterfaceEx(0), 
   getAdaptersAddresses(0),
   getAdaptersInfo(0),
   loadLibraryWithIPv4Failed(false), 
   loadLibraryWithIPv6Failed(false),
   hLib(0)
{
 
   // Note:  IPHLPAPI has been known to conflict with some thirdparty DLL's.
   //        If you don't care about Win95/98/Me as your target system - then
   //        you can define NO_IPHLPAPI so that you are not required to link with this 
   //        library. (SLG)
#if !defined (NO_IPHLPAPI)
   // check to see if the GetAdaptersAddresses() is in the IPHLPAPI library
   HINSTANCE hLib = LoadLibrary(TEXT("iphlpapi.dll"));
   if (hLib == NULL)
   {
      loadLibraryWithIPv6Failed = true;
      loadLibraryWithIPv4Failed = true;
      return;
   }
 
   getBestInterfaceEx = (GetBestInterfaceExProc) GetProcAddress(hLib, TEXT("GetBestInterfaceEx"));
   getAdaptersAddresses = (GetAdaptersAddressesProc) GetProcAddress(hLib, TEXT("GetAdaptersAddresses"));
   getAdaptersInfo = (GetAdaptersInfoProc) GetProcAddress(hLib, TEXT("GetAdaptersInfo"));
   getBestRoute = (GetBestRouteProc) GetProcAddress(hLib, TEXT("GetBestRoute"));
   getIpAddrTable = (GetIpAddrTableProc) GetProcAddress(hLib, TEXT("GetIpAddrTable"));
   if (getAdaptersAddresses == NULL || getBestInterfaceEx == NULL)
   {   
      loadLibraryWithIPv6Failed = true;
   }
   if (getAdaptersInfo == NULL || getBestRoute == NULL || getIpAddrTable == NULL)
   {
      loadLibraryWithIPv4Failed = true;
   }
#else
   loadLibraryWithIPv6Failed = true;
   loadLibraryWithIPv4Failed = true;
#endif
   DebugLog(<< "WinCompat constructor complete!");
}
 
void WinCompat::destroyInstance()
{
    delete mInstance;
    mInstance = 0;
}
 
bool WinCompat::windowsEventLog(WORD type, WORD numStrings, LPCTSTR* strings)
{
    // type can be:
    // EVENTLOG_SUCCESS (0x0000) Information event
    // EVENTLOG_AUDIT_FAILURE (0x0010) Failure Audit event
    // EVENTLOG_AUDIT_SUCCESS (0x0008) Success Audit event
    // EVENTLOG_ERROR_TYPE (0x0001) Error event
    // EVENTLOG_INFORMATION_TYPE (0x0004) Information event
    // EVENTLOG_WARNING_TYPE (0x0002) Warning event
 
    HKEY key;
    long errorCode =
        ::RegCreateKeyEx(HKEY_LOCAL_MACHINE, _T("System\\CurrentControlSet\\Services\\EventLog\\Application\\reSIProcate"),
                         0, NULL, REG_OPTION_NON_VOLATILE, KEY_READ, NULL, &key, NULL);
    if (ERROR_SUCCESS == errorCode)
    {
        ::RegCloseKey(key);
        HANDLE eventLogHandle = ::RegisterEventSource(NULL, _T("reSIProcate"));
        if (eventLogHandle != NULL)
        {
            BOOL retVal = ::ReportEvent(eventLogHandle, type, 0, 0, NULL, numStrings, 0, strings, NULL);
            ::DeregisterEventSource(eventLogHandle);
            return (retVal != FALSE);
        }
    }
    return false;
}
 
WinCompat::~WinCompat()
{
   if(hLib != NULL)
   {
      FreeLibrary(hLib);
   }
}
 
 
#if !defined(NO_IPHLPAPI)
// !slg! - This function is horribly slow (upto 200ms) and can cause serious performance issues for servers.
//         We should consider finding more efficient APIs, or caching some of the results.
GenericIPAddress
WinCompat::determineSourceInterfaceWithIPv6(const GenericIPAddress& destination)
{
   if (instance()->loadLibraryWithIPv6Failed)
   {
      throw Exception("Library iphlpapi.dll with IPv6 support not available", __FILE__,__LINE__);
   }
 
   // Obtain the size of the structure
   IP_ADAPTER_ADDRESSES *pAdapterAddresses;
   DWORD dwRet, dwSize;
   DWORD flags = GAA_FLAG_INCLUDE_PREFIX | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER;
   unsigned short family = destination.isVersion6() ? AF_INET6 : AF_INET;
   dwRet = (instance()->getAdaptersAddresses)(family, flags, NULL, NULL, &dwSize);
   if (dwRet != ERROR_BUFFER_OVERFLOW)  // expected error
      throw Exception("Unexpected return code", __FILE__, __LINE__);
 
   {
      // Allocate memory
      pAdapterAddresses = (IP_ADAPTER_ADDRESSES *) LocalAlloc(LMEM_ZEROINIT,dwSize);
      if (pAdapterAddresses == NULL) 
      {
         throw Exception("Can't find source address for destination", __FILE__,__LINE__);
      }
 
      // Obtain network adapter information (IPv6)
      dwRet = (instance()->getAdaptersAddresses)(family, flags, NULL, pAdapterAddresses, &dwSize);
      if (dwRet != ERROR_SUCCESS) 
      {
         LocalFree(pAdapterAddresses);
         throw Exception("Can't find source address for destination", __FILE__,__LINE__);
      } 
   }
 
   // Check if this address is a local address - this also avoids returning 
   // the loopback address that can cause havoc if the registrar and user agent are on the same box
   IP_ADAPTER_ADDRESSES *AI;
   int i;
   for (i = 0, AI = pAdapterAddresses; AI != NULL; AI = AI->Next, i++) 
   {
      for (PIP_ADAPTER_UNICAST_ADDRESS unicast = AI->FirstUnicastAddress;
           unicast; unicast = unicast->Next)
      {
         if (unicast->Address.lpSockaddr->sa_family != family)
            continue;
 
         if (family == AF_INET && 
             reinterpret_cast<const struct sockaddr_in*>(unicast->Address.lpSockaddr)->sin_addr.S_un.S_addr == 
                                                         destination.v4Address.sin_addr.S_un.S_addr)
         {
            // Return default address for NIC.  Note:  We could also just return the destination, 
            // however returning the default address for NIC is beneficial in cases where the
            // co-located registrar supports redundancy via a Virtual IP address.
            for (PIP_ADAPTER_UNICAST_ADDRESS unicastRet = AI->FirstUnicastAddress;
                 unicastRet; unicastRet = unicastRet->Next)
            {
#if defined(AVOID_TRANSIENT_SOURCE_ADDRESSES)
               if (unicastRet->Flags & IP_ADAPTER_ADDRESS_TRANSIENT)
                  continue;
#endif
 
               GenericIPAddress ipaddress(*unicastRet->Address.lpSockaddr);
               LocalFree(pAdapterAddresses);
               return(ipaddress);
            }
         }
#ifdef USE_IPV6
         else if (family == AF_INET6 && 
                  memcmp(&(reinterpret_cast<const struct sockaddr_in6*>(unicast->Address.lpSockaddr)->sin6_addr), 
                         &(reinterpret_cast<const struct sockaddr_in6*>(&destination.address)->sin6_addr), 
                         sizeof(IN6_ADDR)) == 0)
         {
            for (PIP_ADAPTER_UNICAST_ADDRESS unicastRet = AI->FirstUnicastAddress;
                 unicastRet; unicastRet = unicastRet->Next)
            {
#if defined(AVOID_TRANSIENT_SOURCE_ADDRESSES)
               if (unicastRet->Flags & IP_ADAPTER_ADDRESS_TRANSIENT)
                  continue;
#endif
 
               // explicitly cast to sockaddr_in6, to use that version of GenericIPAddress' ctor. If we don't, then compiler
               // defaults to ctor for sockaddr_in (at least under Win32), which will truncate the lower-bits of the IPv6 address.
               const struct sockaddr_in6* psa = reinterpret_cast<const struct sockaddr_in6*>(unicastRet->Address.lpSockaddr);
 
               // Return default address for NIC.  Note:  We could also just return the destination, 
               // however returning the default address for NIC is beneficial in cases where the
               // co-located registrar supports redundancy via a Virtual IP address.
               GenericIPAddress ipaddress(*psa);
               LocalFree(pAdapterAddresses);
               return(ipaddress);
            }
         }
#endif
      } 
   }
 
   // Not a local address, get the best interface from the OS
   DWORD dwBestIfIndex;
   const sockaddr* saddr = &destination.address;
   if ((instance()->getBestInterfaceEx)((sockaddr *)saddr, &dwBestIfIndex) != NO_ERROR)
   {
      LocalFree(pAdapterAddresses);
      throw Exception("Can't find source address for destination", __FILE__,__LINE__);
   }
 
   for (i = 0, AI = pAdapterAddresses; AI != NULL; AI = AI->Next, i++) 
   {
       for (PIP_ADAPTER_UNICAST_ADDRESS unicast = AI->FirstUnicastAddress;
            unicast; unicast = unicast->Next)
       {
          if (unicast->Address.lpSockaddr->sa_family != saddr->sa_family)
             continue;
 
#if defined(AVOID_TRANSIENT_SOURCE_ADDRESSES)
         if (unicast->Flags & IP_ADAPTER_ADDRESS_TRANSIENT)
            continue;
#endif
 
          if (saddr->sa_family == AF_INET && AI->IfIndex == dwBestIfIndex)
          {
             GenericIPAddress ipaddress(*unicast->Address.lpSockaddr);
             LocalFree(pAdapterAddresses);
             return(ipaddress);
          }
#ifdef USE_IPV6
          else if (saddr->sa_family == AF_INET6 && AI->Ipv6IfIndex == dwBestIfIndex)
          {
             // explicitly cast to sockaddr_in6, to use that version of GenericIPAddress' ctor. If we don't, then compiler
             // defaults to ctor for sockaddr_in (at least under Win32), which will truncate the lower-bits of the IPv6 address.
             const struct sockaddr_in6* psa = reinterpret_cast<const struct sockaddr_in6*>(unicast->Address.lpSockaddr);
             GenericIPAddress ipaddress(*psa);
             LocalFree(pAdapterAddresses);
             return(ipaddress);
          }
#endif
      } 
   }
   LocalFree(pAdapterAddresses);
   throw Exception("Can't find source address for destination", __FILE__,__LINE__);
 
   return GenericIPAddress();
}
 
 
GenericIPAddress
WinCompat::determineSourceInterfaceWithoutIPv6(const GenericIPAddress& destination)
{
   if (instance()->loadLibraryWithIPv4Failed)
   {
      throw Exception("Library iphlpapi.dll not available", __FILE__,__LINE__);
   }
 
   struct sockaddr_in sourceIP;
   memset(&sourceIP, 0, sizeof(sockaddr_in));
   sourceIP.sin_family = AF_INET;
 
   // look through the local ip address - first we want to see if the address is local, if 
   // not then we want to look for the Best route
   PMIB_IPADDRTABLE  pIpAddrTable = NULL;
   ULONG addrSize = 0;
         
   // allocate the space
   DWORD ret = instance()->getIpAddrTable(NULL, &addrSize, FALSE);
   if(ERROR_INSUFFICIENT_BUFFER == ret)
   {
      pIpAddrTable = (PMIB_IPADDRTABLE) new char [addrSize];
      if(pIpAddrTable == 0)
      {
          throw Exception("Can't find source address for destination - unable to new memory", __FILE__,__LINE__);
      }        
   } 
   else 
   {
      throw Exception("Can't find source address for destination (GetIpAddrTable to get buffer space failed), ret=" + Data((uint32_t)ret), __FILE__,__LINE__);
   }
     
   ret = instance()->getIpAddrTable(pIpAddrTable, &addrSize, FALSE);
   if (NO_ERROR != ret) 
   {
      delete [] (char *) pIpAddrTable;
      throw Exception("Can't find source address for destination (GetIpAddrTable failed), addrSize=" + Data((uint32_t)addrSize) + ", ret=" + Data((uint32_t)ret), __FILE__,__LINE__);
   }
 
   // Check if address is local or not
   DWORD i = 0;
   for(i = 0; i <pIpAddrTable->dwNumEntries; i++)
   {
      if(pIpAddrTable->table[i].dwAddr ==
         destination.v4Address.sin_addr.S_un.S_addr)
      {
         // Address is local - no need to find best route - this also avoids returning 
         // 127.0.0.1 that can cause havoc if the registrar and user agent are on the same box
         // Return default address for NIC.  Note:  We could also just return the destination, 
         // however returning the default address for NIC is beneficial in cases where the
         // co-located registrar supports redundancy via a Virtual IP address.
         DWORD dwNicIndex = pIpAddrTable->table[i].dwIndex;
         for(DWORD j = 0; j <pIpAddrTable->dwNumEntries; j++)
         {
#if defined(AVOID_TRANSIENT_SOURCE_ADDRESSES)
            if (pIpAddrTable->table[j].wType & MIB_IPADDR_TRANSIENT)
               continue;
#endif
 
            if(pIpAddrTable->table[j].dwIndex == dwNicIndex)  // Default address is first address found for NIC
            {
               DebugLog(<< "Routing to a local address - returning default address for NIC");
               sourceIP.sin_addr.s_addr = pIpAddrTable->table[j].dwAddr;               
               delete [] (char *) pIpAddrTable;
               return GenericIPAddress(sourceIP);
            }
         }
      }
   }
 
   // try to figure the best route to the destination
   MIB_IPFORWARDROW bestRoute;
   memset(&bestRoute, 0, sizeof(bestRoute));
   const sockaddr_in& sin = (const sockaddr_in&)destination.address;
   ret = instance()->getBestRoute(sin.sin_addr.s_addr, 0, &bestRoute);
   if (NO_ERROR != ret) 
   {
      delete [] (char *) pIpAddrTable;
      throw Exception("Can't find source address for destination, ret=" + Data((uint32_t)ret), __FILE__,__LINE__);
   }
      
   // look through the local ip address to find one that match the best route.
   enum ENICEntryPreference {ENICUnknown = 0, ENextHopNotWithinNICSubnet, ENICSubnetIsAll1s, ENICServicesNextHop};
   ENICEntryPreference eCurrSelection = ENICUnknown;
 
   // try to find a match
   for (i=0; i<pIpAddrTable->dwNumEntries; i++) 
   {
      MIB_IPADDRROW &entry = pIpAddrTable->table[i];
      
      ULONG addr = pIpAddrTable->table[i].dwAddr;
      ULONG gw = bestRoute.dwForwardNextHop;
 
#if defined(AVOID_TRANSIENT_SOURCE_ADDRESSES)
      if (entry.wType & MIB_IPADDR_TRANSIENT)
         continue;
#endif
 
      if(entry.dwIndex == bestRoute.dwForwardIfIndex)    // Note: there MAY be > 1 entry with the same index, see AddIPAddress.
      {
         if( (entry.dwAddr & entry.dwMask) == (bestRoute.dwForwardNextHop & entry.dwMask) )
         {
            sourceIP.sin_addr.s_addr = entry.dwAddr;
            eCurrSelection = ENICServicesNextHop;
            break;
         }
         else if (entry.dwMask == 0xffffffff && eCurrSelection < ENICSubnetIsAll1s)
         {
            sourceIP.sin_addr.s_addr = entry.dwAddr;
            eCurrSelection = ENICSubnetIsAll1s;    // Lucent/Avaya VPN has Subnet Mask of 255.255.255.255. Illegal perhaps but we should use
                                                   // if cannot find one that serves next hop.
         }
         else if (eCurrSelection < ENextHopNotWithinNICSubnet)
         {
            sourceIP.sin_addr.s_addr = entry.dwAddr;
            eCurrSelection = ENextHopNotWithinNICSubnet;   // should use if nothing else works since bestRoute told us to use this NIC.
         }
      }
   }
 
   if (eCurrSelection != ENICServicesNextHop)
   {
      // rarely happens but it does. We would fail before with the old code, let's see what the ip table looks like.
      in_addr subnet, netMask, nextHop;
      subnet.s_addr = bestRoute.dwForwardDest;
      netMask.s_addr = bestRoute.dwForwardMask;
      nextHop.s_addr = bestRoute.dwForwardNextHop;
      // best-route
      DebugLog(<< "Best Route - subnet=" <<DnsUtil::inet_ntop(subnet)
               <<" net-mask=" <<DnsUtil::inet_ntop(netMask)
               <<" next-hop=" <<DnsUtil::inet_ntop(nextHop)
               <<" if-index=" <<bestRoute.dwForwardIfIndex );
      // ip-table
      for (i=0; i<pIpAddrTable->dwNumEntries; i++)
      {
         MIB_IPADDRROW & entry = pIpAddrTable->table[i];
         in_addr nicIP, nicMask;
         nicIP.s_addr = entry.dwAddr;
         nicMask.s_addr = entry.dwMask;
         DebugLog(<<"IP Table entry " <<i+1 <<'/' <<pIpAddrTable->dwNumEntries <<" if-index=" <<entry.dwIndex
                  <<" NIC IP=" <<DnsUtil::inet_ntop(nicIP)
                  << (entry.wType & MIB_IPADDR_TRANSIENT ? " (Transient)" : "")
                  <<" NIC Mask=" <<DnsUtil::inet_ntop(nicMask) );
      }
   }
   
   delete [] (char *) pIpAddrTable;
   if(sourceIP.sin_addr.s_addr == 0)
   {
      throw Exception("Can't find source address for destination", __FILE__,__LINE__);
   }
   return GenericIPAddress(sourceIP);
}
#endif // !defined(NO_IPHLPAPI)
 
GenericIPAddress
WinCompat::determineSourceInterface(const GenericIPAddress& destination)
{
// Note:  IPHLPAPI has been known to conflict with some thirdparty DLL's.
//        If you don't care about Win95/98/Me as your target system - then
//        you can define NO_IPHLPAPI so that you are not required to link with this 
//        library. (SLG)
 
#if !defined(NO_IPHLPAPI)
 
   if(destination.isVersion6())
   {
      return  determineSourceInterfaceWithIPv6(destination);
   }
   else
   {
      return determineSourceInterfaceWithoutIPv6(destination);
   }  
 
#else
   resip_assert(0);
#endif
   return GenericIPAddress();
}
 
 
std::list<std::pair<Data,Data> >
WinCompat::getInterfaces(const Data& matching)
{
   if (instance()->loadLibraryWithIPv6Failed)
   {
      if (instance()->loadLibraryWithIPv4Failed)
      {
         throw Exception("Library iphlpapi.dll not available", __FILE__,__LINE__);
      }
 
      // Do IPV4 only lookup - useful for Windows versions less than W2k3 and WinXp
      // Note:  This query does not include the Loopback Adapter
      PIP_ADAPTER_INFO pAdaptersInfo=NULL;
      std::list<std::pair<Data,Data> > results;
      DWORD dwRet, dwSize=0;
      dwRet = (instance()->getAdaptersInfo)(pAdaptersInfo, &dwSize);
      if (dwRet == ERROR_BUFFER_OVERFLOW)  // expected error
      {
         // Allocate memory
         pAdaptersInfo = (PIP_ADAPTER_INFO) LocalAlloc(LMEM_ZEROINIT,dwSize);
         if (pAdaptersInfo == NULL) 
         {
            throw Exception("Can't query for adapters info - LocalAlloc error", __FILE__,__LINE__);
         }
         dwRet = (instance()->getAdaptersInfo)(pAdaptersInfo, &dwSize);
         if (dwRet != ERROR_SUCCESS) 
         {
            LocalFree(pAdaptersInfo);
            throw Exception("Can't query for adapters info - GetAdaptersInfo", __FILE__,__LINE__);
         } 
         else 
         {
            IP_ADAPTER_INFO *AI;
            int i;
            for (i = 0, AI = pAdaptersInfo; AI != NULL; AI = AI->Next, i++) 
            {
               //Data name(AI->AdapterName);
               Data name(AI->Description);
               if(matching == Data::Empty || name == matching)
               {
                  for (const IP_ADDR_STRING *addr=&AI->IpAddressList; addr; addr = addr->Next)
                  {
                     results.push_back(std::make_pair(name, Data(addr->IpAddress.String)));
                  }
               }
            }
            LocalFree(pAdaptersInfo);
         }
      }
      return results;
   }
 
   // Use IPV6 compatible query
   // Note:  This query includes the Loopback Adapter
   // Obtain the size of the structure
   IP_ADAPTER_ADDRESSES *pAdapterAddresses;
   std::list<std::pair<Data,Data> > results;
   DWORD dwRet, dwSize=0;
   DWORD flags = GAA_FLAG_INCLUDE_PREFIX | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_MULTICAST | GAA_FLAG_SKIP_DNS_SERVER;
   dwRet = (instance()->getAdaptersAddresses)(AF_UNSPEC, flags, NULL, NULL, &dwSize);
   if (dwRet == ERROR_BUFFER_OVERFLOW)  // expected error
   {
      // Allocate memory
      pAdapterAddresses = (IP_ADAPTER_ADDRESSES *) LocalAlloc(LMEM_ZEROINIT,dwSize);
      if (pAdapterAddresses == NULL) 
      {
         throw Exception("Can't query for adapter addresses - LocalAlloc error", __FILE__,__LINE__);
      }
 
      // Obtain network adapter information (IPv6)
      dwRet = (instance()->getAdaptersAddresses)(AF_UNSPEC, flags, NULL, pAdapterAddresses, &dwSize);
      if (dwRet != ERROR_SUCCESS) 
      {
         LocalFree(pAdapterAddresses);
         throw Exception("Can't query for adapter addresses - GetAdapterAddresses", __FILE__,__LINE__);
      } 
      else 
      {
         IP_ADAPTER_ADDRESSES *AI;
         int i;
         for (i = 0, AI = pAdapterAddresses; AI != NULL; AI = AI->Next, i++) 
         {
            if (AI->FirstUnicastAddress != NULL) 
            {
               LPSTR pszSimpleCharStringFromLPWSTR = ConvertLPWSTRToLPSTR(AI->FriendlyName);
               Data name(pszSimpleCharStringFromLPWSTR);
               delete [] pszSimpleCharStringFromLPWSTR;
 
               if(matching == Data::Empty || name == matching)
               {
                  for (PIP_ADAPTER_UNICAST_ADDRESS unicast = AI->FirstUnicastAddress;
                       unicast; unicast = unicast->Next)
                  {
#ifndef USE_IPV6
                     // otherwise we would get 0.0.0.0 for AF_INET6 addresses
                     if (unicast->Address.lpSockaddr->sa_family != AF_INET) continue;
#endif
                     results.push_back(std::make_pair(name, DnsUtil::inet_ntop(*unicast->Address.lpSockaddr)));
                  }
               }
            } 
         }
         LocalFree(pAdapterAddresses);
      }      
   }
   return results;
}
 
 
/* ====================================================================
 * The Vovida Software License, Version 1.0 
 * 
 * Copyright (c) 2000-2005 Vovida Networks, Inc.  All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 * 
 * 3. The names "VOCAL", "Vovida Open Communication Application Library",
 *    and "Vovida Open Communication Application Library (VOCAL)" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact vocal@vovida.org.
 *
 * 4. Products derived from this software may not be called "VOCAL", nor
 *    may "VOCAL" appear in their name, without prior written
 *    permission of Vovida Networks, Inc.
 * 
 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
 * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
 * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
 * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 * 
 * ====================================================================
 * 
 * This software consists of voluntary contributions made by Vovida
 * Networks, Inc. and many individuals on behalf of Vovida Networks,
 * Inc.  For more information on Vovida Networks, Inc., please see
 * <http://www.vovida.org/>.
 *
 */