You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
770 lines
22 KiB
770 lines
22 KiB
/*
|
|
** WS2TCPIP.H - WinSock2 Extension for TCP/IP protocols
|
|
**
|
|
** This file contains TCP/IP specific information for use
|
|
** by WinSock2 compatible applications.
|
|
**
|
|
** Copyright (c) Microsoft Corporation. All rights reserved.
|
|
**
|
|
** To provide the backward compatibility, all the TCP/IP
|
|
** specific definitions that were included in the WINSOCK.H
|
|
** file are now included in WINSOCK2.H file. WS2TCPIP.H
|
|
** file includes only the definitions introduced in the
|
|
** "WinSock 2 Protocol-Specific Annex" document.
|
|
**
|
|
** Rev 0.3 Nov 13, 1995
|
|
** Rev 0.4 Dec 15, 1996
|
|
*/
|
|
|
|
#ifndef _WS2TCPIP_H_
|
|
#define _WS2TCPIP_H_
|
|
|
|
#if _MSC_VER > 1000
|
|
#pragma once
|
|
#endif
|
|
|
|
/* Argument structure for IP_ADD_MEMBERSHIP and IP_DROP_MEMBERSHIP */
|
|
|
|
struct ip_mreq {
|
|
struct in_addr imr_multiaddr; /* IP multicast address of group */
|
|
struct in_addr imr_interface; /* local IP address of interface */
|
|
};
|
|
|
|
/* Argument structure for IP_ADD_SOURCE_MEMBERSHIP, IP_DROP_SOURCE_MEMBERSHIP,
|
|
* IP_BLOCK_SOURCE, and IP_UNBLOCK_SOURCE
|
|
*/
|
|
|
|
struct ip_mreq_source {
|
|
struct in_addr imr_multiaddr; /* IP multicast address of group */
|
|
struct in_addr imr_sourceaddr; /* IP address of source */
|
|
struct in_addr imr_interface; /* local IP address of interface */
|
|
};
|
|
|
|
/* Argument structure for SIO_{GET,SET}_MULTICAST_FILTER */
|
|
|
|
struct ip_msfilter {
|
|
struct in_addr imsf_multiaddr; /* IP multicast address of group */
|
|
struct in_addr imsf_interface; /* local IP address of interface */
|
|
u_long imsf_fmode; /* filter mode - INCLUDE or EXCLUDE */
|
|
u_long imsf_numsrc; /* number of sources in src_list */
|
|
struct in_addr imsf_slist[1];
|
|
};
|
|
|
|
#define IP_MSFILTER_SIZE(numsrc) \
|
|
(sizeof(struct ip_msfilter)-sizeof(struct in_addr) + (numsrc)*sizeof(struct in_addr))
|
|
|
|
#define MCAST_INCLUDE 0
|
|
#define MCAST_EXCLUDE 1
|
|
|
|
/* TCP/IP specific Ioctl codes */
|
|
|
|
#define SIO_GET_INTERFACE_LIST _IOR('t', 127, u_long)
|
|
/* New IOCTL with address size independent address array */
|
|
#define SIO_GET_INTERFACE_LIST_EX _IOR('t', 126, u_long)
|
|
#define SIO_SET_MULTICAST_FILTER _IOW('t', 125, u_long)
|
|
#define SIO_GET_MULTICAST_FILTER _IOW('t', 124 | IOC_IN, u_long)
|
|
|
|
/* Option to use with [gs]etsockopt at the IPPROTO_IP level */
|
|
|
|
#define IP_OPTIONS 1 /* set/get IP options */
|
|
#define IP_HDRINCL 2 /* header is included with data */
|
|
#define IP_TOS 3 /* IP type of service and preced*/
|
|
#define IP_TTL 4 /* IP time to live */
|
|
#define IP_MULTICAST_IF 9 /* set/get IP multicast i/f */
|
|
#define IP_MULTICAST_TTL 10 /* set/get IP multicast ttl */
|
|
#define IP_MULTICAST_LOOP 11 /*set/get IP multicast loopback */
|
|
#define IP_ADD_MEMBERSHIP 12 /* add an IP group membership */
|
|
#define IP_DROP_MEMBERSHIP 13/* drop an IP group membership */
|
|
#define IP_DONTFRAGMENT 14 /* don't fragment IP datagrams */
|
|
#define IP_ADD_SOURCE_MEMBERSHIP 15 /* join IP group/source */
|
|
#define IP_DROP_SOURCE_MEMBERSHIP 16 /* leave IP group/source */
|
|
#define IP_BLOCK_SOURCE 17 /* block IP group/source */
|
|
#define IP_UNBLOCK_SOURCE 18 /* unblock IP group/source */
|
|
#define IP_PKTINFO 19 /* receive packet information for ipv4*/
|
|
#define IP_RECEIVE_BROADCAST 22 /* allow/block broadcast reception */
|
|
|
|
/* Option to use with [gs]etsockopt at the IPPROTO_IPV6 level */
|
|
|
|
#define IPV6_HDRINCL 2 /* Header is included with data */
|
|
#define IPV6_UNICAST_HOPS 4 /* Set/get IP unicast hop limit */
|
|
#define IPV6_MULTICAST_IF 9 /* Set/get IP multicast interface */
|
|
#define IPV6_MULTICAST_HOPS 10 /* Set/get IP multicast ttl */
|
|
#define IPV6_MULTICAST_LOOP 11 /* Set/get IP multicast loopback */
|
|
#define IPV6_ADD_MEMBERSHIP 12 /* Add an IP group membership */
|
|
#define IPV6_DROP_MEMBERSHIP 13 /* Drop an IP group membership */
|
|
#define IPV6_JOIN_GROUP IPV6_ADD_MEMBERSHIP
|
|
#define IPV6_LEAVE_GROUP IPV6_DROP_MEMBERSHIP
|
|
#define IPV6_PKTINFO 19 /* Receive packet information for ipv6 */
|
|
#define IPV6_HOPLIMIT 21 /* Receive packet hop limit */
|
|
#define IPV6_PROTECTION_LEVEL 23 /* Set/get IPv6 protection level */
|
|
|
|
/* Values of IPV6_PROTECTION_LEVEL */
|
|
|
|
#define PROTECTION_LEVEL_UNRESTRICTED 10 /* For peer-to-peer apps */
|
|
#define PROTECTION_LEVEL_DEFAULT 20 /* Default level */
|
|
#define PROTECTION_LEVEL_RESTRICTED 30 /* For Intranet apps */
|
|
|
|
/* Option to use with [gs]etsockopt at the IPPROTO_UDP level */
|
|
|
|
#define UDP_NOCHECKSUM 1
|
|
#define UDP_CHECKSUM_COVERAGE 20 /* Set/get UDP-Lite checksum coverage */
|
|
|
|
/* Option to use with [gs]etsockopt at the IPPROTO_TCP level */
|
|
|
|
#define TCP_EXPEDITED_1122 0x0002
|
|
|
|
|
|
/* IPv6 definitions */
|
|
|
|
#ifndef s6_addr
|
|
|
|
struct in6_addr {
|
|
union {
|
|
u_char Byte[16];
|
|
u_short Word[8];
|
|
} u;
|
|
};
|
|
|
|
#define in_addr6 in6_addr
|
|
|
|
/*
|
|
** Defines to match RFC 2553.
|
|
*/
|
|
#define _S6_un u
|
|
#define _S6_u8 Byte
|
|
#define s6_addr _S6_un._S6_u8
|
|
|
|
/*
|
|
** Defines for our implementation.
|
|
*/
|
|
#define s6_bytes u.Byte
|
|
#define s6_words u.Word
|
|
|
|
#endif
|
|
|
|
/* Argument structure for IPV6_JOIN_GROUP and IPV6_LEAVE_GROUP */
|
|
|
|
typedef struct ipv6_mreq {
|
|
struct in6_addr ipv6mr_multiaddr; /* IPv6 multicast address */
|
|
unsigned int ipv6mr_interface; /* Interface index */
|
|
} IPV6_MREQ;
|
|
|
|
|
|
/* Old IPv6 socket address structure (retained for sockaddr_gen definition below) */
|
|
|
|
struct sockaddr_in6_old {
|
|
short sin6_family; /* AF_INET6 */
|
|
u_short sin6_port; /* Transport level port number */
|
|
u_long sin6_flowinfo; /* IPv6 flow information */
|
|
struct in6_addr sin6_addr; /* IPv6 address */
|
|
};
|
|
|
|
/* IPv6 socket address structure, RFC 2553 */
|
|
|
|
struct sockaddr_in6 {
|
|
short sin6_family; /* AF_INET6 */
|
|
u_short sin6_port; /* Transport level port number */
|
|
u_long sin6_flowinfo; /* IPv6 flow information */
|
|
struct in6_addr sin6_addr; /* IPv6 address */
|
|
u_long sin6_scope_id; /* set of interfaces for a scope */
|
|
};
|
|
|
|
|
|
typedef struct in6_addr IN6_ADDR;
|
|
typedef struct in6_addr *PIN6_ADDR;
|
|
typedef struct in6_addr FAR *LPIN6_ADDR;
|
|
|
|
typedef struct sockaddr_in6 SOCKADDR_IN6;
|
|
typedef struct sockaddr_in6 *PSOCKADDR_IN6;
|
|
typedef struct sockaddr_in6 FAR *LPSOCKADDR_IN6;
|
|
|
|
/* Macro that works for both IPv4 and IPv6 */
|
|
#define SS_PORT(ssp) (((struct sockaddr_in*)(ssp))->sin_port)
|
|
|
|
#define IN6ADDR_ANY_INIT { 0 }
|
|
#define IN6ADDR_LOOPBACK_INIT { 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1 }
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
extern const struct in6_addr in6addr_any;
|
|
extern const struct in6_addr in6addr_loopback;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#ifdef _MSC_VER
|
|
#define WS2TCPIP_INLINE __inline
|
|
#else
|
|
#define WS2TCPIP_INLINE extern inline /* GNU style */
|
|
#endif
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_ADDR_EQUAL(const struct in6_addr *a, const struct in6_addr *b)
|
|
{
|
|
return (memcmp(a, b, sizeof(struct in6_addr)) == 0);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_UNSPECIFIED(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_words[0] == 0) &&
|
|
(a->s6_words[1] == 0) &&
|
|
(a->s6_words[2] == 0) &&
|
|
(a->s6_words[3] == 0) &&
|
|
(a->s6_words[4] == 0) &&
|
|
(a->s6_words[5] == 0) &&
|
|
(a->s6_words[6] == 0) &&
|
|
(a->s6_words[7] == 0));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_LOOPBACK(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_words[0] == 0) &&
|
|
(a->s6_words[1] == 0) &&
|
|
(a->s6_words[2] == 0) &&
|
|
(a->s6_words[3] == 0) &&
|
|
(a->s6_words[4] == 0) &&
|
|
(a->s6_words[5] == 0) &&
|
|
(a->s6_words[6] == 0) &&
|
|
(a->s6_words[7] == 0x0100));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MULTICAST(const struct in6_addr *a)
|
|
{
|
|
return (a->s6_bytes[0] == 0xff);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_LINKLOCAL(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_bytes[0] == 0xfe) &&
|
|
((a->s6_bytes[1] & 0xc0) == 0x80));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_SITELOCAL(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_bytes[0] == 0xfe) &&
|
|
((a->s6_bytes[1] & 0xc0) == 0xc0));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_V4MAPPED(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_words[0] == 0) &&
|
|
(a->s6_words[1] == 0) &&
|
|
(a->s6_words[2] == 0) &&
|
|
(a->s6_words[3] == 0) &&
|
|
(a->s6_words[4] == 0) &&
|
|
(a->s6_words[5] == 0xffff));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_V4COMPAT(const struct in6_addr *a)
|
|
{
|
|
return ((a->s6_words[0] == 0) &&
|
|
(a->s6_words[1] == 0) &&
|
|
(a->s6_words[2] == 0) &&
|
|
(a->s6_words[3] == 0) &&
|
|
(a->s6_words[4] == 0) &&
|
|
(a->s6_words[5] == 0) &&
|
|
!((a->s6_words[6] == 0) &&
|
|
(a->s6_addr[14] == 0) &&
|
|
((a->s6_addr[15] == 0) || (a->s6_addr[15] == 1))));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MC_NODELOCAL(const struct in6_addr *a)
|
|
{
|
|
return IN6_IS_ADDR_MULTICAST(a) && ((a->s6_bytes[1] & 0xf) == 1);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MC_LINKLOCAL(const struct in6_addr *a)
|
|
{
|
|
return IN6_IS_ADDR_MULTICAST(a) && ((a->s6_bytes[1] & 0xf) == 2);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MC_SITELOCAL(const struct in6_addr *a)
|
|
{
|
|
return IN6_IS_ADDR_MULTICAST(a) && ((a->s6_bytes[1] & 0xf) == 5);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MC_ORGLOCAL(const struct in6_addr *a)
|
|
{
|
|
return IN6_IS_ADDR_MULTICAST(a) && ((a->s6_bytes[1] & 0xf) == 8);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6_IS_ADDR_MC_GLOBAL(const struct in6_addr *a)
|
|
{
|
|
return IN6_IS_ADDR_MULTICAST(a) && ((a->s6_bytes[1] & 0xf) == 0xe);
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6ADDR_ISANY(const struct sockaddr_in6 *a)
|
|
{
|
|
return ((a->sin6_family == AF_INET6) &&
|
|
IN6_IS_ADDR_UNSPECIFIED(&a->sin6_addr));
|
|
}
|
|
|
|
WS2TCPIP_INLINE int
|
|
IN6ADDR_ISLOOPBACK(const struct sockaddr_in6 *a)
|
|
{
|
|
return ((a->sin6_family == AF_INET6) &&
|
|
IN6_IS_ADDR_LOOPBACK(&a->sin6_addr));
|
|
}
|
|
|
|
WS2TCPIP_INLINE void
|
|
IN6_SET_ADDR_UNSPECIFIED(struct in6_addr *a)
|
|
{
|
|
memset(a->s6_bytes, 0, sizeof(struct in6_addr));
|
|
}
|
|
|
|
WS2TCPIP_INLINE void
|
|
IN6_SET_ADDR_LOOPBACK(struct in6_addr *a)
|
|
{
|
|
memset(a->s6_bytes, 0, sizeof(struct in6_addr));
|
|
a->s6_bytes[15] = 1;
|
|
}
|
|
|
|
WS2TCPIP_INLINE void
|
|
IN6ADDR_SETANY(struct sockaddr_in6 *a)
|
|
{
|
|
a->sin6_family = AF_INET6;
|
|
a->sin6_port = 0;
|
|
a->sin6_flowinfo = 0;
|
|
IN6_SET_ADDR_UNSPECIFIED(&a->sin6_addr);
|
|
a->sin6_scope_id = 0;
|
|
}
|
|
|
|
WS2TCPIP_INLINE void
|
|
IN6ADDR_SETLOOPBACK(struct sockaddr_in6 *a)
|
|
{
|
|
a->sin6_family = AF_INET6;
|
|
a->sin6_port = 0;
|
|
a->sin6_flowinfo = 0;
|
|
IN6_SET_ADDR_LOOPBACK(&a->sin6_addr);
|
|
a->sin6_scope_id = 0;
|
|
}
|
|
|
|
typedef union sockaddr_gen{
|
|
struct sockaddr Address;
|
|
struct sockaddr_in AddressIn;
|
|
struct sockaddr_in6_old AddressIn6;
|
|
} sockaddr_gen;
|
|
|
|
/* Structure to keep interface specific information */
|
|
|
|
typedef struct _INTERFACE_INFO
|
|
{
|
|
u_long iiFlags; /* Interface flags */
|
|
sockaddr_gen iiAddress; /* Interface address */
|
|
sockaddr_gen iiBroadcastAddress; /* Broadcast address */
|
|
sockaddr_gen iiNetmask; /* Network mask */
|
|
} INTERFACE_INFO, FAR * LPINTERFACE_INFO;
|
|
|
|
/* New structure that does not have dependency on the address size */
|
|
typedef struct _INTERFACE_INFO_EX
|
|
{
|
|
u_long iiFlags; /* Interface flags */
|
|
SOCKET_ADDRESS iiAddress; /* Interface address */
|
|
SOCKET_ADDRESS iiBroadcastAddress; /* Broadcast address */
|
|
SOCKET_ADDRESS iiNetmask; /* Network mask */
|
|
} INTERFACE_INFO_EX, FAR * LPINTERFACE_INFO_EX;
|
|
|
|
/* Possible flags for the iiFlags - bitmask */
|
|
|
|
#define IFF_UP 0x00000001 /* Interface is up */
|
|
#define IFF_BROADCAST 0x00000002 /* Broadcast is supported */
|
|
#define IFF_LOOPBACK 0x00000004 /* this is loopback interface */
|
|
#define IFF_POINTTOPOINT 0x00000008 /*this is point-to-point interface*/
|
|
#define IFF_MULTICAST 0x00000010 /* multicast is supported */
|
|
|
|
|
|
// structure for IP_PKTINFO option
|
|
//
|
|
typedef struct in_pktinfo {
|
|
IN_ADDR ipi_addr; // destination IPv4 address
|
|
UINT ipi_ifindex; // received interface index
|
|
} IN_PKTINFO;
|
|
|
|
C_ASSERT(sizeof(IN_PKTINFO) == 8);
|
|
|
|
// structure for IPV6_PKTINFO option
|
|
//
|
|
typedef struct in6_pktinfo {
|
|
IN6_ADDR ipi6_addr; // destination IPv6 address
|
|
UINT ipi6_ifindex; // received interface index
|
|
} IN6_PKTINFO;
|
|
|
|
C_ASSERT(sizeof(IN6_PKTINFO) == 20);
|
|
|
|
/* Error codes from getaddrinfo() */
|
|
|
|
#define EAI_AGAIN WSATRY_AGAIN
|
|
#define EAI_BADFLAGS WSAEINVAL
|
|
#define EAI_FAIL WSANO_RECOVERY
|
|
#define EAI_FAMILY WSAEAFNOSUPPORT
|
|
#define EAI_MEMORY WSA_NOT_ENOUGH_MEMORY
|
|
//#define EAI_NODATA WSANO_DATA
|
|
#define EAI_NONAME WSAHOST_NOT_FOUND
|
|
#define EAI_SERVICE WSATYPE_NOT_FOUND
|
|
#define EAI_SOCKTYPE WSAESOCKTNOSUPPORT
|
|
|
|
//
|
|
// DCR_FIX: EAI_NODATA remove or fix
|
|
//
|
|
// EAI_NODATA was removed from rfc2553bis
|
|
// need to find out from the authors why and
|
|
// determine the error for "no records of this type"
|
|
// temporarily, we'll keep #define to avoid changing
|
|
// code that could change back; use NONAME
|
|
//
|
|
|
|
#define EAI_NODATA EAI_NONAME
|
|
|
|
|
|
/* Structure used in getaddrinfo() call */
|
|
|
|
typedef struct addrinfo
|
|
{
|
|
int ai_flags; // AI_PASSIVE, AI_CANONNAME, AI_NUMERICHOST
|
|
int ai_family; // PF_xxx
|
|
int ai_socktype; // SOCK_xxx
|
|
int ai_protocol; // 0 or IPPROTO_xxx for IPv4 and IPv6
|
|
size_t ai_addrlen; // Length of ai_addr
|
|
char * ai_canonname; // Canonical name for nodename
|
|
struct sockaddr * ai_addr; // Binary address
|
|
struct addrinfo * ai_next; // Next structure in linked list
|
|
}
|
|
ADDRINFOA, *PADDRINFOA;
|
|
|
|
typedef struct addrinfoW
|
|
{
|
|
int ai_flags; // AI_PASSIVE, AI_CANONNAME, AI_NUMERICHOST
|
|
int ai_family; // PF_xxx
|
|
int ai_socktype; // SOCK_xxx
|
|
int ai_protocol; // 0 or IPPROTO_xxx for IPv4 and IPv6
|
|
size_t ai_addrlen; // Length of ai_addr
|
|
PWSTR ai_canonname; // Canonical name for nodename
|
|
struct sockaddr * ai_addr; // Binary address
|
|
struct addrinfoW * ai_next; // Next structure in linked list
|
|
}
|
|
ADDRINFOW, *PADDRINFOW;
|
|
|
|
// Switchable definition for GetAddrInfo()
|
|
|
|
#ifdef UNICODE
|
|
typedef ADDRINFOW ADDRINFOT, *PADDRINFOT;
|
|
#else
|
|
typedef ADDRINFOA ADDRINFOT, *PADDRINFOT;
|
|
#endif
|
|
|
|
// RFC standard definition for getaddrinfo()
|
|
|
|
typedef ADDRINFOA ADDRINFO, FAR * LPADDRINFO;
|
|
|
|
|
|
|
|
/* Flags used in "hints" argument to getaddrinfo() */
|
|
|
|
#define AI_PASSIVE 0x1 /* Socket address will be used in bind() call */
|
|
#define AI_CANONNAME 0x2 /* Return canonical name in first ai_canonname */
|
|
#define AI_NUMERICHOST 0x4 /* Nodename must be a numeric address string */
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
WINSOCK_API_LINKAGE
|
|
int
|
|
WSAAPI
|
|
getaddrinfo(
|
|
IN const char FAR * nodename,
|
|
IN const char FAR * servname,
|
|
IN const struct addrinfo FAR * hints,
|
|
OUT struct addrinfo FAR * FAR * res
|
|
);
|
|
|
|
#if (_WIN32_WINNT >= 0x0502)
|
|
WINSOCK_API_LINKAGE
|
|
int
|
|
WSAAPI
|
|
GetAddrInfoW(
|
|
IN PCWSTR pNodeName,
|
|
IN PCWSTR pServiceName,
|
|
IN const ADDRINFOW * pHints,
|
|
OUT PADDRINFOW * ppResult
|
|
);
|
|
|
|
#define GetAddrInfoA getaddrinfo
|
|
|
|
#ifdef UNICODE
|
|
#define GetAddrInfo GetAddrInfoW
|
|
#else
|
|
#define GetAddrInfo GetAddrInfoA
|
|
#endif
|
|
#endif
|
|
|
|
#if INCL_WINSOCK_API_TYPEDEFS
|
|
typedef
|
|
int
|
|
(WSAAPI * LPFN_GETADDRINFO)(
|
|
IN const char FAR * nodename,
|
|
IN const char FAR * servname,
|
|
IN const struct addrinfo FAR * hints,
|
|
OUT struct addrinfo FAR * FAR * res
|
|
);
|
|
|
|
typedef
|
|
int
|
|
(WSAAPI * LPFN_GETADDRINFOW)(
|
|
IN PCWSTR pNodeName,
|
|
IN PCWSTR pServiceName,
|
|
IN const ADDRINFOW * pHints,
|
|
OUT PADDRINFOW * ppResult
|
|
);
|
|
|
|
#define LPFN_GETADDRINFOA LPFN_GETADDRINFO
|
|
|
|
#ifdef UNICODE
|
|
#define LPFN_GETADDRINFOT LPFN_GETADDRINFOW
|
|
#else
|
|
#define LPFN_GETADDRINFOT LPFN_GETADDRINFOA
|
|
#endif
|
|
#endif
|
|
|
|
|
|
WINSOCK_API_LINKAGE
|
|
void
|
|
WSAAPI
|
|
freeaddrinfo(
|
|
IN LPADDRINFO pAddrInfo
|
|
);
|
|
|
|
#if (_WIN32_WINNT >= 0x0502)
|
|
WINSOCK_API_LINKAGE
|
|
void
|
|
WSAAPI
|
|
FreeAddrInfoW(
|
|
IN PADDRINFOW pAddrInfo
|
|
);
|
|
|
|
#define FreeAddrInfoA freeaddrinfo
|
|
|
|
#ifdef UNICODE
|
|
#define FreeAddrInfo FreeAddrInfoW
|
|
#else
|
|
#define FreeAddrInfo FreeAddrInfoA
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#if INCL_WINSOCK_API_TYPEDEFS
|
|
typedef
|
|
void
|
|
(WSAAPI * LPFN_FREEADDRINFO)(
|
|
IN struct addrinfo FAR * ai
|
|
);
|
|
typedef
|
|
void
|
|
(WSAAPI * LPFN_FREEADDRINFOW)(
|
|
IN PADDRINFOW * pAddrInfo
|
|
);
|
|
|
|
#define LPFN_FREEADDRINFOA LPFN_FREEADDRINFO
|
|
|
|
#ifdef UNICODE
|
|
#define LPFN_FREEADDRINFOT LPFN_FREEADDRINFOW
|
|
#else
|
|
#define LPFN_FREEADDRINFOT LPFN_FREEADDRINFOA
|
|
#endif
|
|
#endif
|
|
|
|
|
|
typedef int socklen_t;
|
|
|
|
WINSOCK_API_LINKAGE
|
|
int
|
|
WSAAPI
|
|
getnameinfo(
|
|
IN const struct sockaddr FAR * sa,
|
|
IN socklen_t salen,
|
|
OUT char FAR * host,
|
|
IN DWORD hostlen,
|
|
OUT char FAR * serv,
|
|
IN DWORD servlen,
|
|
IN int flags
|
|
);
|
|
|
|
#if (_WIN32_WINNT >= 0x0502)
|
|
WINSOCK_API_LINKAGE
|
|
INT
|
|
WSAAPI
|
|
GetNameInfoW(
|
|
IN const SOCKADDR * pSockaddr,
|
|
IN socklen_t SockaddrLength,
|
|
OUT PWCHAR pNodeBuffer,
|
|
IN DWORD NodeBufferSize,
|
|
OUT PWCHAR pServiceBuffer,
|
|
IN DWORD ServiceBufferSize,
|
|
IN INT Flags
|
|
);
|
|
|
|
#define GetNameInfoA getnameinfo
|
|
|
|
#ifdef UNICODE
|
|
#define GetNameInfo GetNameInfoW
|
|
#else
|
|
#define GetNameInfo GetNameInfoA
|
|
#endif
|
|
#endif
|
|
|
|
#if INCL_WINSOCK_API_TYPEDEFS
|
|
typedef
|
|
int
|
|
(WSAAPI * LPFN_GETNAMEINFO)(
|
|
IN const struct sockaddr FAR * sa,
|
|
IN socklen_t salen,
|
|
OUT char FAR * host,
|
|
IN DWORD hostlen,
|
|
OUT char FAR * serv,
|
|
IN DWORD servlen,
|
|
IN int flags
|
|
);
|
|
|
|
typedef
|
|
INT
|
|
(WSAAPI * LPFN_GETNAMEINFOW)(
|
|
IN const SOCKADDR * pSockaddr,
|
|
IN socklen_t SockaddrLength,
|
|
OUT PWCHAR pNodeBuffer,
|
|
IN DWORD NodeBufferSize,
|
|
OUT PWCHAR pServiceBuffer,
|
|
IN DWORD ServiceBufferSize,
|
|
IN INT Flags
|
|
);
|
|
|
|
#define LPFN_GETNAMEINFOA LPFN_GETNAMEINFO
|
|
|
|
#ifdef UNICODE
|
|
#define LPFN_GETNAMEINFOT LPFN_GETNAMEINFOW
|
|
#else
|
|
#define LPFN_GETNAMEINFOT LPFN_GETNAMEINFOA
|
|
#endif
|
|
#endif
|
|
|
|
|
|
|
|
#if INCL_WINSOCK_API_PROTOTYPES
|
|
#ifdef UNICODE
|
|
#define gai_strerror gai_strerrorW
|
|
#else
|
|
#define gai_strerror gai_strerrorA
|
|
#endif /* UNICODE */
|
|
|
|
// WARNING: The gai_strerror inline functions below use static buffers,
|
|
// and hence are not thread-safe. We'll use buffers long enough to hold
|
|
// 1k characters. Any system error messages longer than this will be
|
|
// returned as empty strings. However 1k should work for the error codes
|
|
// used by getaddrinfo().
|
|
#define GAI_STRERROR_BUFFER_SIZE 1024
|
|
|
|
WS2TCPIP_INLINE
|
|
char *
|
|
gai_strerrorA(
|
|
IN int ecode)
|
|
{
|
|
DWORD dwMsgLen;
|
|
static char buff[GAI_STRERROR_BUFFER_SIZE + 1];
|
|
|
|
dwMsgLen = FormatMessageA(FORMAT_MESSAGE_FROM_SYSTEM
|
|
|FORMAT_MESSAGE_IGNORE_INSERTS
|
|
|FORMAT_MESSAGE_MAX_WIDTH_MASK,
|
|
NULL,
|
|
ecode,
|
|
MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
|
|
(LPSTR)buff,
|
|
GAI_STRERROR_BUFFER_SIZE,
|
|
NULL);
|
|
|
|
return buff;
|
|
}
|
|
|
|
WS2TCPIP_INLINE
|
|
WCHAR *
|
|
gai_strerrorW(
|
|
IN int ecode
|
|
)
|
|
{
|
|
DWORD dwMsgLen;
|
|
static WCHAR buff[GAI_STRERROR_BUFFER_SIZE + 1];
|
|
|
|
dwMsgLen = FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM
|
|
|FORMAT_MESSAGE_IGNORE_INSERTS
|
|
|FORMAT_MESSAGE_MAX_WIDTH_MASK,
|
|
NULL,
|
|
ecode,
|
|
MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
|
|
(LPWSTR)buff,
|
|
GAI_STRERROR_BUFFER_SIZE,
|
|
NULL);
|
|
|
|
return buff;
|
|
}
|
|
#endif /* INCL_WINSOCK_API_PROTOTYPES */
|
|
|
|
|
|
|
|
|
|
#define NI_MAXHOST 1025 /* Max size of a fully-qualified domain name */
|
|
#define NI_MAXSERV 32 /* Max size of a service name */
|
|
|
|
//
|
|
// Maximum length of address literals (potentially including a port number)
|
|
// generated by any address-to-string conversion routine. This length can
|
|
// be used when declaring buffers used with getnameinfo, WSAAddressToString,
|
|
// inet_ntoa, etc. We just provide one define, rather than one per api,
|
|
// to avoid confusion.
|
|
//
|
|
// The totals are derived from the following data:
|
|
// 15: IPv4 address
|
|
// 45: IPv6 address including embedded IPv4 address
|
|
// 11: Scope Id
|
|
// 2: Brackets around IPv6 address when port is present
|
|
// 6: Port (including colon)
|
|
// 1: Terminating null byte
|
|
//
|
|
#define INET_ADDRSTRLEN 22
|
|
#define INET6_ADDRSTRLEN 65
|
|
|
|
/* Flags for getnameinfo() */
|
|
|
|
#define NI_NOFQDN 0x01 /* Only return nodename portion for local hosts */
|
|
#define NI_NUMERICHOST 0x02 /* Return numeric form of the host's address */
|
|
#define NI_NAMEREQD 0x04 /* Error if the host's name not in DNS */
|
|
#define NI_NUMERICSERV 0x08 /* Return numeric form of the service (port #) */
|
|
#define NI_DGRAM 0x10 /* Service is a datagram service */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
//
|
|
// Unless the build environment is explicitly targeting only
|
|
// platforms that include built-in getaddrinfo() support, include
|
|
// the backwards-compatibility version of the relevant APIs.
|
|
//
|
|
#if !defined(_WIN32_WINNT) || (_WIN32_WINNT <= 0x0500)
|
|
#include <wspiapi.h>
|
|
#endif
|
|
|
|
#endif /* _WS2TCPIP_H_ */
|