mstcpip.h

Go to the documentation of this file.

#pragma once

#ifdef __cplusplus
extern "C" {
#endif

#ifndef ASSERT
#define MSTCPIP_ASSERT_UNDEFINED
#define ASSERT(exp) ((VOID) 0)
#endif

#ifdef _MSC_VER
#define MSTCPIP_INLINE __inline
#else
#define MSTCPIP_INLINE static inline
#endif

#include <nldef.h>

struct tcp_keepalive {
  ULONG onoff;
  ULONG keepalivetime;
  ULONG keepaliveinterval;
};

#define SIO_RCVALL _WSAIOW(IOC_VENDOR,1)
#define SIO_RCVALL_MCAST _WSAIOW(IOC_VENDOR,2)
#define SIO_RCVALL_IGMPMCAST _WSAIOW(IOC_VENDOR,3)
#define SIO_KEEPALIVE_VALS _WSAIOW(IOC_VENDOR,4)
#define SIO_ABSORB_RTRALERT _WSAIOW(IOC_VENDOR,5)
#define SIO_UCAST_IF _WSAIOW(IOC_VENDOR,6)
#define SIO_LIMIT_BROADCASTS _WSAIOW(IOC_VENDOR,7)
#define SIO_INDEX_BIND _WSAIOW(IOC_VENDOR,8)
#define SIO_INDEX_MCASTIF _WSAIOW(IOC_VENDOR,9)
#define SIO_INDEX_ADD_MCAST _WSAIOW(IOC_VENDOR,10)
#define SIO_INDEX_DEL_MCAST _WSAIOW(IOC_VENDOR,11)
#define SIO_RCVALL_MCAST_IF _WSAIOW(IOC_VENDOR,13)
#define SIO_RCVALL_IF _WSAIOW(IOC_VENDOR,14)

typedef enum {
  RCVALL_OFF = 0,
  RCVALL_ON = 1,
  RCVALL_SOCKETLEVELONLY = 2,
  RCVALL_IPLEVEL = 3,
} RCVALL_VALUE, *PRCVALL_VALUE;

#define RCVALL_MAX RCVALL_IPLEVEL

typedef struct {
  RCVALL_VALUE Mode;
  ULONG Interface;
} RCVALL_IF, *PRCVALL_IF;

#if (NTDDI_VERSION >= NTDDI_WIN7)
DEFINE_GUID(SOCKET_DEFAULT2_QM_POLICY, 0xaec2ef9c, 0x3a4d, 0x4d3e, 0x88, 0x42, 0x23, 0x99, 0x42, 0xe3, 0x9a, 0x47);
#endif

#define SIO_ACQUIRE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 100)
#define SIO_RELEASE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 101)
#define SIO_ASSOCIATE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 102)

typedef struct _INET_PORT_RANGE {
  USHORT StartPort;
  USHORT NumberOfPorts;
} INET_PORT_RANGE, *PINET_PORT_RANGE;
typedef struct _INET_PORT_RANGE INET_PORT_RESERVATION, *PINET_PORT_RESERVATION;

typedef struct {
  ULONG64 Token;
} INET_PORT_RESERVATION_TOKEN, *PINET_PORT_RESERVATION_TOKEN;

#define INVALID_PORT_RESERVATION_TOKEN ((ULONG64)0)

typedef struct {
#ifdef __cplusplus
  INET_PORT_RESERVATION Reservation;
  INET_PORT_RESERVATION_TOKEN Token;
#else
  INET_PORT_RESERVATION;
  INET_PORT_RESERVATION_TOKEN;
#endif
} INET_PORT_RESERVATION_INSTANCE, *PINET_PORT_RESERVATION_INSTANCE;

typedef struct {
  ULONG AssignmentCount;
  ULONG OwningPid;
} INET_PORT_RESERVATION_INFORMATION, *PINET_PORT_RESERVATION_INFORMATION;

#ifdef _WS2DEF_

#if (NTDDI_VERSION >= NTDDI_VISTA)

#define _SECURE_SOCKET_TYPES_DEFINED_

#define SIO_SET_SECURITY             _WSAIOW(IOC_VENDOR, 200)
#define SIO_QUERY_SECURITY           _WSAIORW(IOC_VENDOR, 201)
#define SIO_SET_PEER_TARGET_NAME     _WSAIOW(IOC_VENDOR, 202)
#define SIO_DELETE_PEER_TARGET_NAME  _WSAIOW(IOC_VENDOR, 203)

#define SIO_SOCKET_USAGE_NOTIFICATION _WSAIOW(IOC_VENDOR, 204)

typedef enum _SOCKET_USAGE_TYPE {
  SYSTEM_CRITICAL_SOCKET = 1
}SOCKET_USAGE_TYPE;

typedef enum _SOCKET_SECURITY_PROTOCOL {
  SOCKET_SECURITY_PROTOCOL_DEFAULT,
  SOCKET_SECURITY_PROTOCOL_IPSEC,
#if (NTDDI_VERSION >= NTDDI_WIN7)
  SOCKET_SECURITY_PROTOCOL_IPSEC2,
#endif
  SOCKET_SECURITY_PROTOCOL_INVALID
} SOCKET_SECURITY_PROTOCOL;

#define SOCKET_SETTINGS_GUARANTEE_ENCRYPTION  0x1
#define SOCKET_SETTINGS_ALLOW_INSECURE  0x2

typedef struct _SOCKET_SECURITY_SETTINGS {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG SecurityFlags;
} SOCKET_SECURITY_SETTINGS;

#define SOCKET_SETTINGS_IPSEC_SKIP_FILTER_INSTANTIATION            0x1

#if (NTDDI_VERSION >= NTDDI_WIN7)

#define SOCKET_SETTINGS_IPSEC_OPTIONAL_PEER_NAME_VERIFICATION      0x2
#define SOCKET_SETTINGS_IPSEC_ALLOW_FIRST_INBOUND_PKT_UNENCRYPTED  0x4
#define SOCKET_SETTINGS_IPSEC_PEER_NAME_IS_RAW_FORMAT              0x8

#endif /* (NTDDI_VERSION >= NTDDI_WIN7) */

typedef struct _SOCKET_SECURITY_SETTINGS_IPSEC {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG SecurityFlags;
  ULONG IpsecFlags;
  GUID AuthipMMPolicyKey;
  GUID AuthipQMPolicyKey;
  GUID Reserved;
  UINT64 Reserved2;
  ULONG UserNameStringLen;
  ULONG DomainNameStringLen;
  ULONG PasswordStringLen;
  wchar_t AllStrings[0];
} SOCKET_SECURITY_SETTINGS_IPSEC;

typedef struct _SOCKET_PEER_TARGET_NAME {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE PeerAddress;
  ULONG PeerTargetNameStringLen;
  wchar_t AllStrings[0];
} SOCKET_PEER_TARGET_NAME;

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE PeerAddress;
  ULONG PeerTokenAccessMask;
} SOCKET_SECURITY_QUERY_TEMPLATE;

#if (NTDDI_VERSION >= NTDDI_WIN7)

#define SOCKET_QUERY_IPSEC2_ABORT_CONNECTION_ON_FIELD_CHANGE 0x1

#define SOCKET_QUERY_IPSEC2_FIELD_MASK_MM_SA_ID 0x1
#define SOCKET_QUERY_IPSEC2_FIELD_MASK_QM_SA_ID 0x2

typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE_IPSEC2 {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  SOCKADDR_STORAGE PeerAddress;
  ULONG PeerTokenAccessMask;
  ULONG Flags;
  ULONG FieldMask;
} SOCKET_SECURITY_QUERY_TEMPLATE_IPSEC2;

#endif /* (NTDDI_VERSION >= NTDDI_WIN7) */

#define SOCKET_INFO_CONNECTION_SECURED  0x1
#define SOCKET_INFO_CONNECTION_ENCRYPTED  0x2
#define SOCKET_INFO_CONNECTION_IMPERSONATED 0x4

typedef struct _SOCKET_SECURITY_QUERY_INFO {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG Flags;
  UINT64 PeerApplicationAccessTokenHandle;
  UINT64 PeerMachineAccessTokenHandle;
} SOCKET_SECURITY_QUERY_INFO;

#if (NTDDI_VERSION >= NTDDI_WIN7)
typedef struct _SOCKET_SECURITY_QUERY_INFO_IPSEC2 {
  SOCKET_SECURITY_PROTOCOL SecurityProtocol;
  ULONG Flags;
  UINT64 PeerApplicationAccessTokenHandle;
  UINT64 PeerMachineAccessTokenHandle;
  UINT64 MmSaId;
  UINT64 QmSaId;
  UINT32 NegotiationWinerr;
  GUID SaLookupContext;
} SOCKET_SECURITY_QUERY_INFO_IPSEC2;
#endif

#define SIO_QUERY_WFP_ALE_ENDPOINT_HANDLE _WSAIOR(IOC_VENDOR, 205)
#define SIO_QUERY_RSS_SCALABILITY_INFO _WSAIOR(IOC_VENDOR, 210)

typedef struct _RSS_SCALABILITY_INFO {
  BOOLEAN RssEnabled;
} RSS_SCALABILITY_INFO, *PRSS_SCALABILITY_INFO;

#endif /* (NTDDI_VERSION >= NTDDI_VISTA) */

#define IN4_CLASSA(i) (((LONG)(i) & 0x00000080) == 0)
#define IN4_CLASSB(i) (((LONG)(i) & 0x000000c0) == 0x00000080)
#define IN4_CLASSC(i) (((LONG)(i) & 0x000000e0) == 0x000000c0)
#define IN4_CLASSD(i) (((LONG)(i) & 0x000000f0) == 0x000000e0)
#define IN4_MULTICAST(i) IN4_CLASSD(i)

#define IN4ADDR_ANY INADDR_ANY
#define IN4ADDR_LOOPBACK 0x0100007f
#define IN4ADDR_BROADCAST INADDR_BROADCAST
#define IN4ADDR_NONE INADDR_NONE
#define IN4ADDR_ANY_INIT { 0 }
#define IN4ADDR_LOOPBACK_INIT { 0x7f, 0, 0, 1 }
#define IN4ADDR_BROADCAST_INIT { 0xff, 0xff, 0xff, 0xff }
#define IN4ADDR_ALLNODESONLINK_INIT { 0xe0, 0, 0, 1 }
#define IN4ADDR_ALLROUTERSONLINK_INIT { 0xe0, 0, 0, 2 }
#define IN4ADDR_ALLIGMPV3ROUTERSONLINK_INIT { 0xe0, 0, 0, 0x16 }
#define IN4ADDR_ALLTEREDONODESONLINK_INIT { 0xe0, 0, 0, 0xfd }
#define IN4ADDR_LINKLOCALPREFIX_INIT { 0xa9, 0xfe, }
#define IN4ADDR_MULTICASTPREFIX_INIT { 0xe0, }

#define IN4ADDR_LOOPBACKPREFIX_LENGTH 8
#define IN4ADDR_LINKLOCALPREFIX_LENGTH 16
#define IN4ADDR_MULTICASTPREFIX_LENGTH 4

#if (NTDDI_VERSION >= NTDDI_WIN2KSP1)

MSTCPIP_INLINE
BOOLEAN
IN4_ADDR_EQUAL(
  _In_ CONST IN_ADDR *a,
  _In_ CONST IN_ADDR *b)
{
  return (BOOLEAN)(a->s_addr == b->s_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN4_UNALIGNED_ADDR_EQUAL(
  _In_ CONST IN_ADDR UNALIGNED *a,
  _In_ CONST IN_ADDR UNALIGNED *b)
{
  return (BOOLEAN)(a->s_addr == b->s_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_UNSPECIFIED(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)(a->s_addr == IN4ADDR_ANY);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_UNSPECIFIED(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  return (BOOLEAN)(a->s_addr == IN4ADDR_ANY);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_LOOPBACK(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)(*((PUCHAR) a) == 0x7f);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_LOOPBACK(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  return (BOOLEAN)(*((PUCHAR) a) == 0x7f);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_BROADCAST(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_BROADCAST(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_MULTICAST(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)IN4_MULTICAST(a->s_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_MULTICAST(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  return (BOOLEAN)IN4_MULTICAST(a->s_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_LINKLOCAL(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_LINKLOCAL(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9); // 169.254/16
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_SITELOCAL(
  _In_ CONST IN_ADDR *a)
{
  UNREFERENCED_PARAMETER(a);
  return FALSE;
}
#define IN4_IS_UNALIGNED_ADDR_SITELOCAL IN4_IS_ADDR_SITELOCAL

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_RFC1918(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)(((a->s_addr & 0x00ff) == 0x0a) ||
                   ((a->s_addr & 0xf0ff) == 0x10ac) ||
                   ((a->s_addr & 0xffff) == 0xa8c0));
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_RFC1918(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  IN_ADDR Ipv4Address = *a;
  return IN4_IS_ADDR_RFC1918(&Ipv4Address);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_MC_LINKLOCAL(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)((a->s_addr & 0xffffff) == 0xe0);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_MC_ADMINLOCAL(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)((a->s_addr & 0xffff) == 0xffef);
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_MC_SITELOCAL(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)((a->s_addr & 0xff) == 0xef) &&
                  !IN4_IS_ADDR_MC_ADMINLOCAL(a);
}

MSTCPIP_INLINE
VOID
IN4ADDR_SETSOCKADDR(
  _Out_ PSOCKADDR_IN a,
  _In_ CONST IN_ADDR *addr,
  _In_ USHORT port)
{
  a->sin_family = AF_INET;
  a->sin_port = port;
  a->sin_addr = *addr;
  memset(a->sin_zero, 0, sizeof(a->sin_zero));
}

MSTCPIP_INLINE
VOID
IN4ADDR_SETANY(
  _Out_ PSOCKADDR_IN a)
{
  a->sin_family = AF_INET;
  a->sin_port = 0;
  a->sin_addr.s_addr = IN4ADDR_ANY;
  memset(a->sin_zero, 0, sizeof(a->sin_zero));
}

MSTCPIP_INLINE
VOID
IN4ADDR_SETLOOPBACK(
  _Out_ PSOCKADDR_IN a)
{
  a->sin_family = AF_INET;
  a->sin_port = 0;
  a->sin_addr.s_addr = IN4ADDR_LOOPBACK;
  memset(a->sin_zero, 0, sizeof(a->sin_zero));
}

MSTCPIP_INLINE
BOOLEAN
IN4ADDR_ISANY(
  _In_ CONST SOCKADDR_IN *a)
{
  ASSERT(a->sin_family == AF_INET);
  return IN4_IS_ADDR_UNSPECIFIED(&a->sin_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN4ADDR_ISLOOPBACK(
  _In_ CONST SOCKADDR_IN *a)
{
  ASSERT(a->sin_family == AF_INET);
  return IN4_IS_ADDR_LOOPBACK(&a->sin_addr);
}

MSTCPIP_INLINE
SCOPE_ID
IN4ADDR_SCOPE_ID(
  _In_ CONST SOCKADDR_IN *a)
{
  SCOPE_ID UnspecifiedScopeId = {{{0}}};
  UNREFERENCED_PARAMETER(a);
  return UnspecifiedScopeId;
}

MSTCPIP_INLINE
BOOLEAN
IN4ADDR_ISEQUAL(
  _In_ CONST SOCKADDR_IN *a,
  _In_ CONST SOCKADDR_IN *b)
{
  ASSERT(a->sin_family == AF_INET);
  return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == IN4ADDR_SCOPE_ID(b).Value &&
                   IN4_ADDR_EQUAL(&a->sin_addr, &b->sin_addr));
}

MSTCPIP_INLINE
BOOLEAN
IN4ADDR_ISUNSPECIFIED(
  _In_ CONST SOCKADDR_IN *a)
{
  ASSERT(a->sin_family == AF_INET);
  return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == 0 &&
                   IN4_IS_ADDR_UNSPECIFIED(&a->sin_addr));
}

#define INET_IS_ALIGNED(Pointer, Type) \
   (((ULONG_PTR)Pointer & (TYPE_ALIGNMENT(Type)-1)) == 0)

MSTCPIP_INLINE
SCOPE_LEVEL
Ipv4UnicastAddressScope(
  _In_ CONST UCHAR *Address)
{
  IN_ADDR Ipv4Address;

  if (!INET_IS_ALIGNED(Address, IN_ADDR)) {
      Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address;
      Address = (CONST UCHAR *) &Ipv4Address;
  }
  if (IN4_IS_ADDR_LINKLOCAL((PIN_ADDR) Address) ||
      IN4_IS_ADDR_LOOPBACK((PIN_ADDR) Address)) {
      return ScopeLevelLink;
  }
  return ScopeLevelGlobal;
}

MSTCPIP_INLINE
SCOPE_LEVEL
Ipv4MulticastAddressScope(
  _In_ CONST UCHAR *Address)
{
  IN_ADDR Ipv4Address;

  if (!INET_IS_ALIGNED(Address, IN_ADDR)) {
    Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address;
    Address = (CONST UCHAR *) &Ipv4Address;
  }
  if (IN4_IS_ADDR_MC_LINKLOCAL((PIN_ADDR) Address)) {
    return ScopeLevelLink;
  } else if (IN4_IS_ADDR_MC_ADMINLOCAL((PIN_ADDR) Address)) {
    return ScopeLevelAdmin;
  } else if (IN4_IS_ADDR_MC_SITELOCAL((PIN_ADDR) Address)) {
    return ScopeLevelSite;
  } else {
    return ScopeLevelGlobal;
  }
}

MSTCPIP_INLINE
SCOPE_LEVEL
Ipv4AddressScope(
  _In_ CONST UCHAR *Address)
{
  CONST IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address;

  if (IN4_IS_ADDR_BROADCAST(&Ipv4Address)) {
    return ScopeLevelLink;
  } else if (IN4_IS_ADDR_MULTICAST(&Ipv4Address)) {
    return Ipv4MulticastAddressScope((UCHAR *) &Ipv4Address);
  } else {
    return Ipv4UnicastAddressScope((UCHAR *) &Ipv4Address);
  }
}

MSTCPIP_INLINE
NL_ADDRESS_TYPE
Ipv4AddressType(
  _In_ CONST UCHAR *Address)
{
  IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *) Address;

  if (IN4_IS_ADDR_MULTICAST(&Ipv4Address)) {
    return NlatMulticast;
  }
  if (IN4_IS_ADDR_BROADCAST(&Ipv4Address)) {
    return NlatBroadcast;
  }
  if (IN4_IS_ADDR_UNSPECIFIED(&Ipv4Address)) {
    return NlatUnspecified;
  }
  if (((Ipv4Address.s_addr & 0x000000ff) == 0) ||
    ((Ipv4Address.s_addr & 0x000000f0) == 240)) {
    return NlatInvalid;
  }
  return NlatUnicast;
}

MSTCPIP_INLINE
VOID
IN4_UNCANONICALIZE_SCOPE_ID(
  _In_ CONST IN_ADDR *Address,
  _Inout_ SCOPE_ID *ScopeId)
{
  SCOPE_LEVEL ScopeLevel = Ipv4AddressScope((CONST UCHAR *)Address);

  if ((IN4_IS_ADDR_LOOPBACK(Address)) || (ScopeLevel == ScopeLevelGlobal)) {
    ScopeId->Value = 0;
  }
  if ((SCOPE_LEVEL)ScopeId->Level == ScopeLevel) {
    ScopeId->Level = 0;
  }
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_ADDR_6TO4ELIGIBLE(
  _In_ CONST IN_ADDR *a)
{
  return (BOOLEAN)((Ipv4AddressType((CONST UCHAR *) a) == NlatUnicast) &&
                   !(IN4_IS_ADDR_LOOPBACK(a) ||
                     IN4_IS_ADDR_LINKLOCAL(a) ||
                     IN4_IS_ADDR_SITELOCAL(a) ||
                     IN4_IS_ADDR_RFC1918(a)));
}

MSTCPIP_INLINE
BOOLEAN
IN4_IS_UNALIGNED_ADDR_6TO4ELIGIBLE(
  _In_ CONST IN_ADDR UNALIGNED *a)
{
  IN_ADDR Ipv4Address = *a;
  return IN4_IS_ADDR_6TO4ELIGIBLE(&Ipv4Address);
}

#endif /* (NTDDI_VERSION >= NTDDI_WIN2KSP1) */

#endif /* _WS2DEF_ */

#ifdef _WS2IPDEF_

MSTCPIP_INLINE
BOOLEAN
IN6_PREFIX_EQUAL(
  _In_ CONST IN6_ADDR *a,
  _In_ CONST IN6_ADDR *b,
  _In_ UINT8 len)
{
  UINT8 Bytes = len / 8;
  UINT8 Bits = len % 8;
  UINT8 Mask = 0xff << (8 - Bits);

  ASSERT(len <= (sizeof(IN6_ADDR) * 8));
  return (BOOLEAN) (((memcmp(a, b, Bytes)) == 0) && ((Bits == 0) ||
                    ((a->s6_bytes[Bytes] | Mask) == (b->s6_bytes[Bytes] | Mask))));
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_ALLNODESONNODE(
  _In_ CONST IN6_ADDR *a)
{
  return IN6_ADDR_EQUAL(a, &in6addr_allnodesonnode);
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_ALLNODESONLINK(
  _In_ CONST IN6_ADDR *a)
{
  return IN6_ADDR_EQUAL(a, &in6addr_allnodesonlink);
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_ALLROUTERSONLINK(
  _In_ CONST IN6_ADDR *a)
{
  return IN6_ADDR_EQUAL(a, &in6addr_allroutersonlink);
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_SOLICITEDNODE(
  _In_ CONST IN6_ADDR *a)
{
  return IN6_PREFIX_EQUAL(a, &in6addr_solicitednodemulticastprefix,
                          IN6ADDR_SOLICITEDNODEMULTICASTPREFIX_LENGTH);
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_ISATAP(
  _In_ CONST IN6_ADDR *a)
{
  return (BOOLEAN)(((a->s6_words[4] & 0xfffd) == 0x0000) &&
                   (a->s6_words[5] == 0xfe5e));
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_6TO4(
  _In_ CONST IN6_ADDR *a)
{
  C_ASSERT(IN6ADDR_6TO4PREFIX_LENGTH == RTL_BITS_OF(USHORT));
  return (BOOLEAN)(a->s6_words[0] == in6addr_6to4prefix.s6_words[0]);
}

MSTCPIP_INLINE
BOOLEAN
IN6_IS_ADDR_TEREDO(
  _In_ CONST IN6_ADDR *a)
{
  C_ASSERT(IN6ADDR_TEREDOPREFIX_LENGTH == 2 * RTL_BITS_OF(USHORT));
  return (BOOLEAN)
      (((a->s6_words[0] == in6addr_teredoprefix.s6_words[0]) &&
        (a->s6_words[1] == in6addr_teredoprefix.s6_words[1])) ||
       ((a->s6_words[0] == in6addr_teredoprefix_old.s6_words[0]) &&
        (a->s6_words[1] == in6addr_teredoprefix_old.s6_words[1])));
}

MSTCPIP_INLINE
BOOLEAN
IN6ADDR_ISV4MAPPED(
  _In_ CONST SOCKADDR_IN6 *a)
{
  ASSERT(a->sin6_family == AF_INET6);
  return IN6_IS_ADDR_V4MAPPED(&a->sin6_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN6ADDR_ISISATAP(
  _In_ CONST SOCKADDR_IN6 *a)
{
  ASSERT(a->sin6_family == AF_INET6);
  return IN6_IS_ADDR_ISATAP(&a->sin6_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN6ADDR_IS6TO4(
  _In_ CONST SOCKADDR_IN6 *a)
{
  ASSERT(a->sin6_family == AF_INET6);
  return IN6_IS_ADDR_6TO4(&a->sin6_addr);
}

MSTCPIP_INLINE
BOOLEAN
IN6ADDR_ISTEREDO(
  _In_ CONST SOCKADDR_IN6 *a)
{
  ASSERT(a->sin6_family == AF_INET6);
  return IN6_IS_ADDR_TEREDO(&a->sin6_addr);
}

MSTCPIP_INLINE
CONST UCHAR*
IN6_GET_ADDR_V4MAPPED(
  _In_ CONST IN6_ADDR *Ipv6Address)
{
  return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
}

MSTCPIP_INLINE
CONST UCHAR*
IN6_GET_ADDR_V4COMPAT(
  _In_ CONST IN6_ADDR *Ipv6Address)
{
  return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
}

MSTCPIP_INLINE
CONST UCHAR*
IN6_EXTRACT_V4ADDR_FROM_ISATAP(
  _In_ CONST IN6_ADDR *Ipv6Address)
{
  return (CONST UCHAR *) (Ipv6Address->s6_words + 6);
}

MSTCPIP_INLINE
CONST UCHAR*
IN6_EXTRACT_V4ADDR_FROM_6TO4(
  _In_ CONST IN6_ADDR *Ipv6Address)
{
  return (CONST UCHAR *) (Ipv6Address->s6_words + 1);
}

MSTCPIP_INLINE
VOID
IN6_SET_ADDR_V4MAPPED(
  _Out_ PIN6_ADDR a6,
  _In_ CONST IN_ADDR* a4)
{
  *a6 = in6addr_v4mappedprefix;
  a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0];
  a6->s6_bytes[13] = ((CONST UCHAR *) a4)[1];
  a6->s6_bytes[14] = ((CONST UCHAR *) a4)[2];
  a6->s6_bytes[15] = ((CONST UCHAR *) a4)[3];
}

MSTCPIP_INLINE
VOID
IN6_SET_ADDR_V4COMPAT(
  _Out_ PIN6_ADDR a6,
  _In_ CONST IN_ADDR* a4)
{
  *a6 = in6addr_any;
  a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0];
  a6->s6_bytes[13] = ((CONST UCHAR *) a4)[1];
  a6->s6_bytes[14] = ((CONST UCHAR *) a4)[2];
  a6->s6_bytes[15] = ((CONST UCHAR *) a4)[3];
}

MSTCPIP_INLINE
VOID
IN6_SET_ADDR_SOLICITEDNODE(
  _Out_ PIN6_ADDR Multicast,
  _In_ CONST IN6_ADDR *Unicast)
{
  *Multicast = in6addr_solicitednodemulticastprefix;
  Multicast->s6_bytes[13] = Unicast->s6_bytes[13];
  Multicast->s6_bytes[14] = Unicast->s6_bytes[14];
  Multicast->s6_bytes[15] = Unicast->s6_bytes[15];
}

MSTCPIP_INLINE
VOID
IN6_SET_ISATAP_IDENTIFIER(
  _Inout_ IN6_ADDR *Ipv6Address,
  _In_ CONST IN_ADDR *Ipv4Address)
{
  if (IN4_IS_ADDR_6TO4ELIGIBLE(Ipv4Address)) {
    Ipv6Address->s6_words[4] = 0x0002;
  } else {
    Ipv6Address->s6_words[4] = 0x0000;
  }
  Ipv6Address->s6_words[5] = 0xFE5E;
  *((UNALIGNED IN_ADDR *) (Ipv6Address->s6_words + 6)) = *Ipv4Address;
}

MSTCPIP_INLINE
VOID
IN6_SET_6TO4_PREFIX(
  _Inout_ IN6_ADDR *Ipv6Address,
  _In_ CONST IN_ADDR *Ipv4Address)
{
  Ipv6Address->s6_words[0] = 0x0220;
  *((UNALIGNED IN_ADDR *) (Ipv6Address->s6_words + 1)) = *Ipv4Address;
  Ipv6Address->s6_words[3] = 0x0000;
}

MSTCPIP_INLINE
SCOPE_LEVEL
Ipv6UnicastAddressScope(
  _In_ CONST UCHAR *Address)
{
  IN6_ADDR Ipv6Address;

  if (!INET_IS_ALIGNED(Address, IN6_ADDR)) {
    Ipv6Address = *(CONST IN6_ADDR UNALIGNED *)Address;
    Address = (CONST UCHAR *) &Ipv6Address;
  }
  if (IN6_IS_ADDR_LINKLOCAL((PIN6_ADDR) Address) ||
    IN6_IS_ADDR_LOOPBACK((PIN6_ADDR) Address)) {
    return ScopeLevelLink;
  } else if (IN6_IS_ADDR_SITELOCAL((PIN6_ADDR) Address)) {
    return ScopeLevelSite;
  } else {
    return ScopeLevelGlobal;
  }
}

MSTCPIP_INLINE
SCOPE_LEVEL
IN6_MULTICAST_SCOPE(
  _In_ CONST UCHAR *Address)
{
  PIN6_ADDR Ipv6Address = (PIN6_ADDR) Address;
  return (SCOPE_LEVEL)(Ipv6Address->s6_bytes[1] & 0xf);
}

MSTCPIP_INLINE
SCOPE_LEVEL
Ipv6AddressScope(
  _In_ CONST UCHAR *Address)
{
  if (IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR *) Address)) {
    return IN6_MULTICAST_SCOPE(Address);
  } else {
    return Ipv6UnicastAddressScope(Address);
  }
}

MSTCPIP_INLINE
NL_ADDRESS_TYPE
Ipv6AddressType(
  _In_ CONST UCHAR *Address)
{
  CONST IN6_ADDR *Ipv6Address = (CONST IN6_ADDR *) Address;
  CONST UCHAR *Ipv4Address;

  if (IN6_IS_ADDR_MULTICAST(Ipv6Address)) {
    return NlatMulticast;
  }
  if (IN6_IS_ADDR_UNSPECIFIED(Ipv6Address)) {
    return NlatUnspecified;
  }
  if (IN6_IS_ADDR_ISATAP(Ipv6Address) || IN6_IS_ADDR_V4COMPAT(Ipv6Address) ||
      IN6_IS_ADDR_V4MAPPED(Ipv6Address) || IN6_IS_ADDR_V4TRANSLATED(Ipv6Address)) {
    Ipv4Address = IN6_EXTRACT_V4ADDR_FROM_ISATAP(Ipv6Address);
  } else if (IN6_IS_ADDR_6TO4(Ipv6Address)) {
  Ipv4Address = IN6_EXTRACT_V4ADDR_FROM_6TO4(Ipv6Address);
  } else {
    return NlatUnicast;
  }
  if (Ipv4AddressType(Ipv4Address) != NlatUnicast) {
    return NlatInvalid;
  }
  return NlatUnicast;
}

MSTCPIP_INLINE
VOID
IN6_UNCANONICALIZE_SCOPE_ID(
  _In_ CONST IN6_ADDR *Address,
  _Inout_ SCOPE_ID *ScopeId)
{
  SCOPE_LEVEL ScopeLevel = Ipv6AddressScope((CONST UCHAR *)Address);

  if ((IN6_IS_ADDR_LOOPBACK(Address)) || (ScopeLevel == ScopeLevelGlobal)) {
      ScopeId->Value = 0;
  }
  if ((SCOPE_LEVEL)ScopeId->Level == ScopeLevel) {
    ScopeId->Level = 0;
  }
}

#if (NTDDI_VERSION >= NTDDI_VISTA)

MSTCPIP_INLINE
VOID
IN6ADDR_SETSOCKADDR(
  _Out_ PSOCKADDR_IN6 a,
  _In_ CONST IN6_ADDR *addr,
  _In_ SCOPE_ID scope,
  _In_ USHORT port)
{
  a->sin6_family = AF_INET6;
  a->sin6_port = port;
  a->sin6_flowinfo = 0;
  RtlCopyMemory(&a->sin6_addr, addr, sizeof(IN6_ADDR));
  a->sin6_scope_struct = scope;
  IN6_UNCANONICALIZE_SCOPE_ID(&a->sin6_addr, &a->sin6_scope_struct);
}

MSTCPIP_INLINE
VOID
IN6ADDR_SETV4MAPPED(
  _Out_ PSOCKADDR_IN6 a6,
  _In_ CONST IN_ADDR* a4,
  _In_ SCOPE_ID scope,
  _In_ USHORT port)
{
  a6->sin6_family = AF_INET6;
  a6->sin6_port = port;
  a6->sin6_flowinfo = 0;
  IN6_SET_ADDR_V4MAPPED(&a6->sin6_addr, a4);
  a6->sin6_scope_struct = scope;
  IN4_UNCANONICALIZE_SCOPE_ID(a4, &a6->sin6_scope_struct);
}

#endif /* (NTDDI_VERSION >= NTDDI_VISTA) */

MSTCPIP_INLINE
BOOLEAN
INET_ADDR_EQUAL(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a,
  _In_ CONST VOID* b)
{
  if (af == AF_INET6) {
    return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b);
  } else {
    ASSERT(af == AF_INET);
    return IN4_ADDR_EQUAL((CONST IN_ADDR*)a, (CONST IN_ADDR*)b);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_UNALIGNED_ADDR_EQUAL(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a,
  _In_ CONST VOID* b)
{
  if (af == AF_INET6) {
    return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b);
  } else {
    ASSERT(af == AF_INET);
    return IN4_UNALIGNED_ADDR_EQUAL((CONST IN_ADDR*)a, (CONST IN_ADDR*)b);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_IS_ADDR_UNSPECIFIED(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a)
{
  if (af == AF_INET6) {
    return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a);
  } else {
    ASSERT(af == AF_INET);
    return IN4_IS_ADDR_UNSPECIFIED((CONST IN_ADDR*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_IS_UNALIGNED_ADDR_UNSPECIFIED(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a)
{
  if (af == AF_INET6) {
    return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a);
  } else {
    ASSERT(af == AF_INET);
    return IN4_IS_UNALIGNED_ADDR_UNSPECIFIED((CONST IN_ADDR UNALIGNED*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_IS_ADDR_LOOPBACK(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a)
{
  if (af == AF_INET6) {
    return IN6_IS_ADDR_LOOPBACK((CONST IN6_ADDR*)a);
  } else {
    ASSERT(af == AF_INET);
    return IN4_IS_ADDR_LOOPBACK((CONST IN_ADDR*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_IS_ADDR_BROADCAST(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a)
{
  if (af == AF_INET6) {
    return FALSE;
  } else {
    ASSERT(af == AF_INET);
    return IN4_IS_ADDR_BROADCAST((CONST IN_ADDR*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INET_IS_ADDR_MULTICAST(
  _In_ ADDRESS_FAMILY af,
  _In_ CONST VOID* a)
{
  if (af == AF_INET6) {
    return IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR*)a);
  } else {
    ASSERT(af == AF_INET);
    return IN4_IS_ADDR_MULTICAST((CONST IN_ADDR*)a);
  }
}

MSTCPIP_INLINE
CONST UCHAR*
INET_ADDR_UNSPECIFIED(
  _In_ ADDRESS_FAMILY af)
{
  if (af == AF_INET6) {
    return (CONST UCHAR*)&in6addr_any;
  } else {
    ASSERT(af == AF_INET);
    return (CONST UCHAR*)&in4addr_any;
  }
}

MSTCPIP_INLINE
VOID
INET_SET_ADDRESS(
  _In_ ADDRESS_FAMILY Family,
  _Out_ PUCHAR Address,
  _In_ CONST UCHAR *Value)
{
  if (Family == AF_INET6) {
    *((PIN6_ADDR)Address) = *((PIN6_ADDR)Value);
  } else {
    ASSERT(Family == AF_INET);
    *((PIN_ADDR)Address) = *((PIN_ADDR)Value);
  }
}

MSTCPIP_INLINE
SIZE_T
INET_ADDR_LENGTH(
  _In_ ADDRESS_FAMILY af)
{
  if (af == AF_INET6) {
    return sizeof(IN6_ADDR);
  } else {
    ASSERT(af == AF_INET);
    return sizeof(IN_ADDR);
  }
}

MSTCPIP_INLINE
SIZE_T
INET_SOCKADDR_LENGTH(
  _In_ ADDRESS_FAMILY af)
{
  if (af == AF_INET6) {
    return sizeof(SOCKADDR_IN6);
  } else {
    ASSERT(af == AF_INET);
    return sizeof(SOCKADDR_IN);
  }
}

#if (NTDDI_VERSION >= NTDDI_VISTA)
MSTCPIP_INLINE
VOID
INETADDR_SETSOCKADDR(
  _In_ ADDRESS_FAMILY af,
  _Out_ PSOCKADDR a,
  _In_ CONST VOID* addr,
  _In_ SCOPE_ID scope,
  _In_ USHORT port)
{
  if (af == AF_INET6) {
    IN6ADDR_SETSOCKADDR((PSOCKADDR_IN6) a, (CONST IN6_ADDR *) addr, scope, port);
  } else {
    CONST IN_ADDR addr4 = *((IN_ADDR UNALIGNED *) addr);
    ASSERT(af == AF_INET);
    IN4ADDR_SETSOCKADDR((PSOCKADDR_IN) a, (CONST IN_ADDR *) &addr4, port);
  }
}
#endif /* (NTDDI_VERSION >= NTDDI_VISTA) */

MSTCPIP_INLINE
VOID
INETADDR_SETANY(
  _Inout_ PSOCKADDR a)
{
  if (a->sa_family == AF_INET6) {
    IN6ADDR_SETANY((PSOCKADDR_IN6)a);
  } else {
    ASSERT(a->sa_family == AF_INET);
    IN4ADDR_SETANY((PSOCKADDR_IN)a);
  }
}

MSTCPIP_INLINE
VOID
INETADDR_SETLOOPBACK(
  _Inout_ PSOCKADDR a)
{
  if (a->sa_family == AF_INET6) {
    IN6ADDR_SETLOOPBACK((PSOCKADDR_IN6)a);
  } else {
    ASSERT(a->sa_family == AF_INET);
    IN4ADDR_SETLOOPBACK((PSOCKADDR_IN)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INETADDR_ISANY(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return IN6ADDR_ISANY((CONST SOCKADDR_IN6*)a);
  } else {
    ASSERT(a->sa_family == AF_INET);
    return IN4ADDR_ISANY((CONST SOCKADDR_IN*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INETADDR_ISLOOPBACK(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return IN6ADDR_ISLOOPBACK((CONST SOCKADDR_IN6*)a);
  } else {
    ASSERT(a->sa_family == AF_INET);
    return IN4ADDR_ISLOOPBACK((CONST SOCKADDR_IN*)a);
  }
}

MSTCPIP_INLINE
BOOLEAN
INETADDR_ISV4MAPPED(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return IN6ADDR_ISV4MAPPED((CONST SOCKADDR_IN6*)a);
  } else {
    return FALSE;
  }
}

MSTCPIP_INLINE
BOOLEAN
NL_ADDR_EQUAL(
  _In_ ADDRESS_FAMILY af,
  _In_ SCOPE_ID sa,
  _In_ CONST UCHAR* aa,
  _In_ SCOPE_ID sb,
  _In_ CONST UCHAR* ab)
{
  return (BOOLEAN)((sa.Value == sb.Value) && INET_ADDR_EQUAL(af, aa, ab));
}

MSTCPIP_INLINE
BOOLEAN
NL_IS_ADDR_UNSPECIFIED(
  _In_ ADDRESS_FAMILY af,
  _In_ SCOPE_ID s,
  _In_ CONST UCHAR* a)
{
  return (BOOLEAN)((s.Value == 0) && INET_IS_ADDR_UNSPECIFIED(af, a));
}

MSTCPIP_INLINE
BOOLEAN
INETADDR_ISEQUAL(
  _In_ CONST SOCKADDR *a,
  _In_ CONST SOCKADDR *b)
{
  if (a->sa_family == AF_INET6) {
    return (BOOLEAN) (b->sa_family == AF_INET6 &&
           IN6ADDR_ISEQUAL((CONST SOCKADDR_IN6*)a, (CONST SOCKADDR_IN6*)b));
  } else {
    ASSERT(a->sa_family == AF_INET);
    return (BOOLEAN) (b->sa_family == AF_INET &&
           IN4ADDR_ISEQUAL((CONST SOCKADDR_IN*)a, (CONST SOCKADDR_IN*)b));
  }
}

MSTCPIP_INLINE
BOOLEAN
INETADDR_ISUNSPECIFIED(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return IN6ADDR_ISUNSPECIFIED((CONST SOCKADDR_IN6*)a);
  } else {
    ASSERT(a->sa_family == AF_INET);
    return IN4ADDR_ISUNSPECIFIED((CONST SOCKADDR_IN*)a);
  }
}

#if (NTDDI_VERSION >= NTDDI_VISTA)
MSTCPIP_INLINE
SCOPE_ID
INETADDR_SCOPE_ID(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return ((CONST SOCKADDR_IN6*)a)->sin6_scope_struct;
  } else {
    ASSERT(a->sa_family == AF_INET);
    return IN4ADDR_SCOPE_ID((CONST SOCKADDR_IN*)a);
  }
}
#endif

MSTCPIP_INLINE
USHORT
INETADDR_PORT(
  _In_ CONST SOCKADDR *a)
{
  if (a->sa_family == AF_INET6) {
    return ((CONST SOCKADDR_IN6*)a)->sin6_port;
  } else {
    ASSERT(a->sa_family == AF_INET);
    return ((CONST SOCKADDR_IN*)a)->sin_port;
  }
}

MSTCPIP_INLINE
PUCHAR
INETADDR_ADDRESS(
  _In_ CONST SOCKADDR* a)
{
  if (a->sa_family == AF_INET6) {
    return (PUCHAR)&((PSOCKADDR_IN6)a)->sin6_addr;
  } else {
    ASSERT(a->sa_family == AF_INET);
    return (PUCHAR)&((PSOCKADDR_IN)a)->sin_addr;
  }
}

MSTCPIP_INLINE
VOID
INETADDR_SET_PORT(
  _Inout_ PSOCKADDR a,
  _In_ USHORT Port)
{
  SS_PORT(a) = Port;
}

MSTCPIP_INLINE
VOID
INETADDR_SET_ADDRESS(
  _Inout_ PSOCKADDR a,
  _In_ CONST UCHAR *Address)
{
  if (a->sa_family == AF_INET6) {
    ((PSOCKADDR_IN6)a)->sin6_addr = *((CONST IN6_ADDR*)Address);
  } else {
    ASSERT(a->sa_family == AF_INET);
    ((PSOCKADDR_IN)a)->sin_addr = *((CONST IN_ADDR*)Address);
  }
}

MSTCPIP_INLINE
VOID
INET_UNCANONICALIZE_SCOPE_ID(
  _In_ ADDRESS_FAMILY AddressFamily,
  _In_ CONST UCHAR *Address,
  _Inout_ SCOPE_ID *ScopeId)
{
  if (AddressFamily == AF_INET6) {
    IN6_UNCANONICALIZE_SCOPE_ID((CONST IN6_ADDR*) Address, ScopeId);
  } else {
    IN4_UNCANONICALIZE_SCOPE_ID((CONST IN_ADDR*) Address, ScopeId);
  }
}

#endif /* _WS2IPDEF_ */

#ifndef __IP2STRING__
#define __IP2STRING__

#if (NTDDI_VERSION >= NTDDI_VISTA)

#ifdef _WS2DEF_

NTSYSAPI
PSTR
NTAPI
RtlIpv4AddressToStringA(
  _In_ const struct in_addr *Addr,
  _Out_writes_(16) PSTR S);

NTSYSAPI
LONG
NTAPI
RtlIpv4AddressToStringExA(
  _In_ const struct in_addr *Address,
  _In_ USHORT Port,
  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PSTR AddressString,
  _Inout_ PULONG AddressStringLength);

NTSYSAPI
PWSTR
NTAPI
RtlIpv4AddressToStringW(
  _In_ const struct in_addr *Addr,
  _Out_writes_(16) PWSTR S);

NTSYSAPI
LONG
NTAPI
RtlIpv4AddressToStringExW(
  _In_ const struct in_addr *Address,
  _In_ USHORT Port,
  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PWSTR AddressString,
  _Inout_ PULONG AddressStringLength);

NTSYSAPI
LONG
NTAPI
RtlIpv4StringToAddressA(
  _In_ PCSTR String,
  _In_ BOOLEAN Strict,
  _Out_ PCSTR *Terminator,
  _Out_ struct in_addr *Addr);

NTSYSAPI
LONG
NTAPI
RtlIpv4StringToAddressExA(
  _In_ PCSTR AddressString,
  _In_ BOOLEAN Strict,
  _Out_ struct in_addr *Address,
  _Out_ PUSHORT Port);

NTSYSAPI
LONG
NTAPI
RtlIpv4StringToAddressW(
  _In_ PCWSTR String,
  _In_ BOOLEAN Strict,
  _Out_ PCWSTR *Terminator,
  _Out_ struct in_addr *Addr);

NTSYSAPI
LONG
NTAPI
RtlIpv4StringToAddressExW(
  _In_ PCWSTR AddressString,
  _In_ BOOLEAN Strict,
  _Out_ struct in_addr *Address,
  _Out_ PUSHORT Port);

#ifdef UNICODE
#define RtlIpv4AddressToString RtlIpv4AddressToStringW
#define RtlIpv4StringToAddress RtlIpv4StringToAddressW
#define RtlIpv4AddressToStringEx RtlIpv4AddressToStringExW
#define RtlIpv4StringToAddressEx RtlIpv4StringToAddressExW
#else
#define RtlIpv4AddressToString RtlIpv4AddressToStringA
#define RtlIpv4StringToAddress RtlIpv4StringToAddressA
#define RtlIpv4AddressToStringEx RtlIpv4AddressToStringExA
#define RtlIpv4StringToAddressEx RtlIpv4StringToAddressExA
#endif

#endif /* _WS2DEF_ */

#ifdef _WS2IPDEF_

NTSYSAPI
PSTR
NTAPI
RtlIpv6AddressToStringA(
  _In_ const struct in6_addr *Addr,
  _Out_writes_(46) PSTR S);

NTSYSAPI
LONG
NTAPI
RtlIpv6AddressToStringExA(
  _In_ const struct in6_addr *Address,
  _In_ ULONG ScopeId,
  _In_ USHORT Port,
  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PSTR AddressString,
  _Inout_ PULONG AddressStringLength);

NTSYSAPI
PWSTR
NTAPI
RtlIpv6AddressToStringW(
  _In_ const struct in6_addr *Addr,
  _Out_writes_(46) PWSTR S);

NTSYSAPI
LONG
NTAPI
RtlIpv6AddressToStringExW(
  _In_ const struct in6_addr *Address,
  _In_ ULONG ScopeId,
  _In_ USHORT Port,
  _Out_writes_to_(*AddressStringLength, *AddressStringLength) PWSTR AddressString,
  _Inout_ PULONG AddressStringLength);

NTSYSAPI
LONG
NTAPI
RtlIpv6StringToAddressA(
  _In_ PCSTR S,
  _Out_ PCSTR *Terminator,
  _Out_ struct in6_addr *Addr);

NTSYSAPI
LONG
NTAPI
RtlIpv6StringToAddressExA(
  _In_ PCSTR AddressString,
  _Out_ struct in6_addr *Address,
  _Out_ PULONG ScopeId,
  _Out_ PUSHORT Port);

NTSYSAPI
LONG
NTAPI
RtlIpv6StringToAddressW(
  _In_ PCWSTR S,
  _Out_ PCWSTR *Terminator,
  _Out_ struct in6_addr *Addr);

NTSYSAPI
LONG
NTAPI
RtlIpv6StringToAddressExW(
  _In_ PCWSTR AddressString,
  _Out_ struct in6_addr *Address,
  _Out_ PULONG ScopeId,
  _Out_ PUSHORT Port);

#ifdef UNICODE
#define RtlIpv6AddressToString RtlIpv6AddressToStringW
#define RtlIpv6StringToAddress RtlIpv6StringToAddressW
#define RtlIpv6StringToAddressEx RtlIpv6StringToAddressExW
#define RtlIpv6AddressToStringEx RtlIpv6AddressToStringExW
#else
#define RtlIpv6AddressToString RtlIpv6AddressToStringA
#define RtlIpv6StringToAddress RtlIpv6StringToAddressA
#define RtlIpv6StringToAddressEx RtlIpv6StringToAddressExA
#define RtlIpv6AddressToStringEx RtlIpv6AddressToStringExA
#endif

#endif /* __WS2IPDEF__ */

#ifdef _WS2DEF_

union _DL_EUI48;
typedef union _DL_EUI48 DL_EUI48, *PDL_EUI48;

NTSYSAPI
PSTR
NTAPI
RtlEthernetAddressToStringA(
  _In_ const DL_EUI48 *Addr,
  _Out_writes_(18) PSTR S);

NTSYSAPI
PWSTR
NTAPI
RtlEthernetAddressToStringW(
  _In_ const DL_EUI48 *Addr,
  _Out_writes_(18) PWSTR S);

NTSYSAPI
LONG
NTAPI
RtlEthernetStringToAddressA(
  _In_ PCSTR S,
  _Out_ PCSTR *Terminator,
  _Out_ DL_EUI48 *Addr);

NTSYSAPI
LONG
NTAPI
RtlEthernetStringToAddressW(
  _In_ PCWSTR S,
  _Out_ LPCWSTR *Terminator,
  _Out_ DL_EUI48 *Addr);

#ifdef UNICODE
#define RtlEthernetAddressToString RtlEthernetAddressToStringW
#define RtlEthernetStringToAddress RtlEthernetStringToAddressW
#else
#define RtlEthernetAddressToString RtlEthernetAddressToStringA
#define RtlEthernetStringToAddress RtlEthernetStringToAddressA
#endif

#endif /* _WS2DEF_ */

#endif /* (NTDDI >= NTDDI_VISTA) */

#endif /* __IP2STRING__ */

#ifdef __cplusplus
}
#endif