Windows 网络编程

 网络编程 API

 ，失败返回 -，错误代码 WSASYSNOTREADY 表示基础网络子系统没有准备好网络通行，WSAVERNOTSUPPORTED 表示 Socket 版本不支持，WSAEINPROGRESS 表示一个阻塞的 Sockets 操作在进程中，WSAEPROCLIM 表示 Sockets 支持的任务数到达上限，WSAEFAULT 表示 lpWSAData 不是一个有效指针
 WORD MAKEWORD( X, Y );                获得 wVersionRequested 正确值，WinSock 库版本，高位指定副版本，低位制定主版本
 WSAEnumProtocols();                查询协议信息
 ，失败返回错误信息

 SOCKET socket( ）；成功返回套接字，失败返回 INVALID_SOCKET
 int bing( SOCKET s, const struct sockaddr FAR *name, int namelen );        失败返回 SOCKET_ERROR 错误，使用 TCP/IP 时返回 WSAEADDRINUSE 错误表示端口已经被用或处于 TIME_WAIT 状态，如果绑定一个已经绑定的套接字将返回 WASEFAULT
 ，错误返回 -，常见错误信息是 WSAEINVAL 表示在监听之前未调用 bind
 SOCKET accept( SOCKET s, struct sockaddr *addr, int *addrlen );            s 是出于监听状态的描述字；addr 是一个有效的地址，在 accpt 返回后包含客户机的 IP 地址信息；addrlen 是 addr 的长度；成功返回新的套接字
 ， WSAECONREFUSED 表示要连接的计算机没有监听指定端口的这一进程，WSAETIMEOUT 表示连接超时

  表示无特殊行为，MSG_DONTROUTE 表示要求传输层不要把它发出的数据报路由出去，MSG_OOB 表示数据应该被带外发送；成功返回发送的字节数，错误返回 -，错误信息为 WSAECONNABORTED 表示虚拟回路由于超时或协议有错而中断时，WSAECONNRESET 表示远程主机套接字被强行或意外关闭，WSAETIMEOUT 表示由于网络故障或远程主机系统异常而引起连接中断；成功调用 send 并不意味着数据传输成功，如传送系统的缓冲区空间不够，除非套接字出于非阻塞 I/O 方式，否则 send 函数被阻塞
  表示无特殊行为，为 MSG_PEEK 表示将有用数据复制到所需缓冲区后不从系统缓冲区删除它们
 int shutdown( SOCKET s, int how );        中断连接，防止丢失数据，发送端通知接收端不再发送数据或接收端通知发送端不再接受数据；无论如何 shutdown 函数都不会阻塞；how 为 SD_RECEIVE 表示不再接收数据，SD_SEND 表示不再发送数据，SD_BOTH 不再接收和发送
 int closesocket( SOCKET s );            关闭套接字；调用关闭了的套接字会出现 WSAENOTSOCK 错误

 int recvfrom( SOCKET s, char *buf, int len, int flags, struct sockaddr *from, int *fromlen );            当函数返回时 from 中填入发送数据端的地址
 int sendto( SOCKET s, const char *buf, int len, int flags, const struct sockaddr *to, int tolen );        to 带有接收数据的套接字目标地址信息

 unsigned  位无符号长整型，同时取 IP 地址为 INADDR_ANY 以允许服务器应用监听主机上每个网络接口上的客户端活动
 char *inet_ntoa( struct in_addr in );        将 in_addr 结构转换到点分十进制 IP
 u_short htons( u_short hostshort );
 u_long ntohs( u_long netlong );

 ，失败返回 -
 struct hostent *gethostbyname( const char *name );        name 是指向主机名的指针，可由 gethostname 得到
 struct hostent *gethostbyaddr( const char *addr );

 ；设置为非阻塞模式后 WinSock API 会立刻返回，这些调用在大多数情况下会失败，返回 WSAEWOULDBLOCK 信息表示请求的操作在调用期间没有时间完成
 int getsocketopt( SOCKET s, int level, int optname, char *optval, int *optlen );

 IO 复用

 int select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, const struct timeval *timeout );    nfds 用来对齐，可以忽略；WinSock 提供了 FD_SETSIZE 变量确定集合中最多的套接字描述字数目，可用 #define 自定义；成功返回 0，失败返回 -1
 FD_CLR( s, *set );                从集合中删除描述字
 FD_ISSET( s, *，否则返回
 FD_SET( s, *set );                向集合中添加 s
 FD_ZERO( *set );                将 set 初始化为空集 NULL

 int WSAAsycSelect( SOCKET s, HWND hwnd, unsigned int wMsg, long lEvent );        将网络事件产生的消息发送给应用程序窗口句柄

 注册表操作

 LONG RegopenKeyEX( HKEY hkey, LPCTSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult );        打开一个指定的注册表键；hkey 作为输入参数，可取值 HKEY_CLASS_ROOT, HKEY_CURRENT_CONFIG, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_USERS, HKEY_PERFORMANCE_DATA( NT ), HKEY_DYN_DATA( 9x )；lpSubKey 作为输入参数指向一个非中断字符串包含将要打开键的名称，字符串以  值
 LONG RegCloseKey( HKEY hkey );            释放制定注册键的句柄；成功返回 ERROR_SUCCESS，失败返回非  值
 LONG RegCreateKeyEx( HKEY hkey, LPCTSTR lpSubKey, DWORD Reserved, LPTSTR lpClass, DWORD dwOptions, REGSAM samDesired, LPSECURITY_ATTRIBUTES lpSecurityAttributes, PHKEY phkResult, LPDWORD lpdwDisposition );        打开一个注册表键值，键存在时打开它，不存在则创建；Reserved 必须设置为 ；lpClass 是一个字符串指针，指定键的类型，常为 NULL；dwOptions 指定键的特殊选项；lpSecurityAttributes 是一个指针，指定访问的安全特性；lpdwDisposition 指明参数是被创建还是被打开，REG_CREATE_NEW_KEY 表示创建，REG_OPEND_EXISTING_KEY 表示打开；成功返回 ERROR_SUCCESS， 失败返回非
 LONG RegDeleteKey( HKEY hKey, LPCTSTR lpSubKey );        删除一个注册表键值，删除的键值必须要有访问权限；lpSubKey 是删除的子键，但它不能有子键，他不能为空，键值不区分大小写；成功返回 ，失败返回非
 LONG RegQueryValueEx( HKEY hKey, LPCTSTR lpValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData );        获取指定键的数据和类型；lpValueName 是指要获取数据名字；lpType 用于装载取回数据的类型；lpData 是用于装载指定值的缓冲区；lpcbData 是用于装载 lpData 缓冲区长度，返回成功时设为实际装载的长度
 RegEnumKeyEx

 网络基本应用

 UCHAR NetBIOS( PNCB pNCB );

 IP 配置信息管理

 DWORD GetNetworkParams( PFIXED_INFO pFixedInfo, PULONG pOutBufLen );        获取本地计算机网络参数；pFixedInfo 参数用来返回本地计算机的网络参数； pOutBufLen 作为输入时指定 pFixedInfo 缓冲区大小，作为输出时如果提供的缓冲区不够函数返回需要缓冲区大小；成功返回 ERROR_SUCCESS
 DWORD GetNumberOfInterfaces( PDWORD pdwNumIf );            返回本地计算机网络接口的数量； pdwNumIf 获取数量；成功返回 NO_ERROR
 DWORD GetInterfaceInfo( PIP_INTERFACE_INFO pIfTable, PULONG dwOutBufLen );    返回本地计算机上网络接口适配器列表； pIfTable 返回适配器列表，如果 pfIftable 为 NULL 或空，则 dwOutBufLen 返回所需缓冲区大小；成功返回 NO_ERROR；失败返回 ERROR_INSUFFICIENT_BUFFER 表示缓冲区大小不够，需重新分配
 DWORD GetIfEntry( PMIB_IFROM pIfRow );            返回一个包含特定适配器信息的 MIB_IFROW 结构
 DWORD SetIfEntry( PMIB_IFROM pIfRow );
 DWORD GetIfTable( PMIB_IFTABLE pIfTable, PULONG pdwSize, BOOL bOrder );        获取整个 MIB_IF 接口表的信息；pdwSize 作为输入时指定 pIfTable 缓冲区大小；作为输入时若提供的缓冲区不足，则返回所需缓冲区大小；bOrder 指定返回的接口表中的入口是否按照接口索引升序排列
 DWORD GetIpAddrTable( PMIB_IPADDRTABLE pIpAddrTable, PULONG pdwSize, BOOL bOrder );        取得一张包含了 IP 地址到接口的映射表； pdwSize 输入时指定 pIpAddrTable 缓冲区大小，输出时表示缓冲区不足，返回所需缓冲区大小；
 DWORD AddIPAddress( IPADDR Address, IPMask IpMask, DWORD IfIndex, PULONG NTEContext, PULONG NTEInstance );    向特定接口添加临时 IP 地址；IfIndex 是适配器索引；NTEContext 网络表入口；NTEInstance 网络表实例
 DWORD DeleteIPAddress( ULONG NTEContext );        删除 IP 地址
 BOOL DhcpNotifyConfigChange( LPWSTR lpwszServerName, LPWSTR lpwszAdapterName, BOOL bNewIpAddress, DWORD dwIpIndex, DWORD dwIpAddress, DWORD dwSubNetMask,  不修改，  启动 DHCP ，  禁用 DHCP

 辅助函数

  );        获得 IP 地址，是网络字节序，lpAddr 等于 hostent.h_addr_list[]；调用 .isEmpty() 方法可以判断是否得到 IP 地址
 ,
 HGLOBAL GlobalAlloc( UINT uFlags, DWORDdwBytes );        全局堆分配，提供这个函数只是为了与  位的 Windows 相兼容；分配属性(方式)，GMEM_ZEROINIT 申请内存初始化为 ， GMEM_MOVEABLE 分配可移动内存，返回指针， GMEM_FIXED分配固定内存，返回指针， GPTR 固定和初始化， GHND 移动和初始化，分配的字节数；成功返回句柄，失败返回 NULL
 GlobalFree

 char *LoadLibrary( char * );                    加载库文件；成功返回指向库文件名的指针 library_point，失败返回 NULL
 char *FreeLibrary( char * );
 char *GetProcAddress( library_point, function_name );        成功返回函数的别名，可通过别名调用函数

 strlen_s
 char *strrev( char *s );                    字符串反转，不包括 NULL, Linux系统中没有 __strrev 函数
 itoa
 int atoi( const char *nptr );                    字符串转化为整数

 头文件

 conio.h
 IPHlpApi.h            IP 助手
 nb30.h
 Winbase.h            包含在 windows.h 中
 WinDef.h            类型定义
 Windows.h
 WinNT.h                WCHAR, CHAR, CCHAR
 WinSock1.h
 WinSock2.h            WSAPROTOCOL_INFO
 wtypes.h

 库文件            #pragma comment( lib, "netapi32.lib");

 iphlpapi.lib            IP 助手
 Kernel32.lib.            GlobalAlloc
 netapi32.lib            NCB
 ws2_32.lib            WinSock2

 自定义类型

 BOOL                typedef int BOOL;
 BOOLEAN                typedef BYTE BOOLEAN;
 BYTE                typedef unsigned char BYTE;
 CCHAR                typedef char CCHAR;
 CHAR                typedef char CHAR;系统移植
 CONST                #define CONST const
 DWORD                typedef unsigned -bit unsigned integer
 INT                typedef int INT; 32bits
 INT8                typedef signed char INT8;
 INT16                typedef signed short INT16;
 INT32                typedef signed int INT32;
 INT64                typedef signed __int64 INT64;
 LONG                typedef -bit signed integer
 LONGLONG            #if !defined(_M_IX86) typedef __int64 LONGLONG; #else typedef double LONGLONG; #endif(C++)
 PVOID                typedef void *PVOID;
 TCHAR                #ifdef UNICODE typedef WCHAR TCHAR; #else typedef char TCHAR; #endif
 UCAHR                typedef unsigned char UCHAR;
 WCHAR                typedef wchar_t WCHAR; -bit Unicode character
 WORD                typedef unsigned short WORD;

 fd_set
 HANDLE                typedef PVOID HANDLE;
 HGLOBAL                typedef HANDLE HGLOBAL;
 HKEY                typedef HANDLE HKEY;
 LANA_ENUM            该结构中包含系统中逻辑网卡数目及每个网卡号；LANA 编号对应于网卡及传输协议的唯一组合
 LPCTSTR
 PHKEY
 PIP_ADAPTER_INFO
 REGSAM

 https://msdn.microsoft.com/en-us/library/aa383751

 结构体

 typedef struct WSAData{
     WORD wVersion;                        //希望使用的 Winsock 版本，
     WORD wHighVersion;                    //返回现有 WinSock 库的最高版本
     ];            //长度不能超过 256，通常不使用
     ];        //长度不能超过 256，通常不使用
     unsigned short iMaxSockets;                //可同时打开的套接字数，不固定，一般不使用
     unsigned short iMaxUdpDg;                //数据报最大长度，一般不使用，用 WSAEnumProtocols 查询
     char FAR *lpVendorInfo;                    //不使用
     char FAR *LPWSADATA;
 }WASDATA, *LPWSADATA;

 struct sockaddr{
     u_short sa_family;
     ];
 };

 struct sockaddr_in{
     short sin_family;                    //必须设为 AF_INET
     u_short sin_port;                    //要把端口号由主机字节序转换为网络字节序，设置为 0 则由应用程序分配一个 1024～5000 之间的一个端口
     struct in_addr sin_addr;                //存放 4 位字节无符号长整型的 IP 地址
     ];                    //填充项
 }

 typedef struct in_addr {
         union {
                 struct {
                         u_char s_b1,s_b2,s_b3,s_b4;
                 } S_un_b;
                 struct {
                         u_short s_w1,s_w2;
                 } S_un_w;
                 u_long S_addr;
         } S_un;
 } IN_ADDR, *PIN_ADDR, FAR *LPIN_ADDR;

 typedef struct {
         union {
                 struct {
                         u_char s_b1,s_b2,s_b3,s_b4;
                 } S_un_b;
                 struct {
                         u_short s_w1,s_w2;
                 } S_un_w;
                 u_long S_addr;
         } S_un;
 } IPAddr;

 struct timeval{
     long tv_sec;
     long tv_usec;                        //毫秒
 }

 struct hostent{
     char *h_name;
     char *h_aliases;
     short h_addrtype;                    // 一般为 AF_INET
     short h_length;                        // 一般为 4
     char *h_addr_list;                    // 存放 ip 地址列表的数组，每个元素存放一个 IP 地址
 }

 typedef struct _NCB{                        // 网络控制块
     UCHAR ncb_command;                    NetBIOS 执行的命令
     UCHAR ncb_retcode;                    操作的返回代码
     UCHAR ncb_lsn;                        对应本地会话编号
     UCHAR ncb_num;                        指定本地会话编号
     PUCHAR ncb_buffer;                    数据缓冲区
     WORD ncb_length;                    缓冲区长度
     UCHAR ncb_callname[NCBNAMSZ];                指定远程应用的名字
     UCHAR ncb_name[NCBNAMSZ];                指定应用程序已知的名字
     UCHAR ncb_rto;                        接受操作的时限
     UCHAR ncb_sto;                        发送操作的时限
     void( CALLBACK *ncb_post )( struct _NCB *);        制定异步命令完成后需要调用的后例程的地址
     UCHAR ncb_lana_num;                    指定上面执行命令的 LANA 编号
     UCHAR ncb_cmd_cplt;                    指定操作的返回代码
 #ifdef _WIN64
     UCHAR ncb_reserve[];                    保留字段
 #else
     UCHAR ncb_reserve[];
 #endif
     HANDLE ncb_event;                    设置为“未传信”状态
 }NCB, *PNCB;

 typedef struct _WSAPROTOCOL_INFO {
     DWORD dwServiceFlags1;                    表示不同协议属性的一个位字段；XP1_CONNECTIONLESS（0x00000001），XP1_GUARANTEED_DELIVERY，XP1_GUARANTEED_ORDER，XP1_MESSAGE_ORIENTED，XP1_PSEUDO_STREAM，XP1_GRACEFUL_CLOSE，XP1_EXPEDITED_DATA，XP1_CONNECT_DATA，XP1_DISCONNECT_DATA，XP1_SUPPORT_BROADCAST，XP1_SUPPORT_MULTIPOINT，XP1_MULTIPOINT_CONTROL_PLANE，XP1_MULTIPOINT_DATA_PLANE，XP1_QOS_SUPPORTED，XP1_INTERRUPT，XP1_UNI_SEND，XP1_UNI_RECV，XP1_IFS_HANDLES，XP1_PARTIAL_MESSAGE，XP1_SAN_SUPPORT_SDP
     DWORD dwServiceFlags2;                    Reserved for additional protocol-attribute definitions.
     DWORD dwServiceFlags3;                    Reserved for additional protocol-attribute definitions.
     DWORD dwServiceFlags4;                    Reserved for additional protocol-attribute definitions.
     DWORD dwProviderFlags;
     GUID  ProviderId;                    协议提供商
     DWORD dwCatalogEntryId;                    A unique identifier assigned by the WS2_32.DLL for each WSAPROTOCOL_INFO structure
     WSAPROTOCOLCHAIN ProtocolChain;                协议链
     int iVersion;                        The protocol version identifier.
     int iAddressFamily;                    地址簇；区分正确协议的定义结构；AF_INET，AF_IPX，AF_APPLETALK，AF_NETBIOS，AF_INET6，AF_IRDA，AF_BTH
     int iMaxSockAddr;                    The maximum address length, in bytes.
     int iMinSockAddr;                    The minimum address length, in bytes.
     int iSocketType;                    定义套接字类型；SOCK_STREAM，SOCK_DGRAM，SOCK_RAW，SOCK_RDM，SOCK_SEQPACKET
     int iProtocol;                        定义该条目属于哪一个协议；IPPROTO_ICMP，IPPROTO_IGMP，BTHPROTO_RFCOMM，IPPROTO_TCP，IPPROTO_UDP，IPPROTO_ICMPV6，IPPROTO_RM
     int iProtocolMaxOffset;
      and
     int iSecurityScheme;                    支持的安全特性
     DWORD dwMessageSize;                    The maximum message size, in bytes, supported by the protocol；
     DWORD dwProviderReserved;                Reserved for use by service providers
     TCHAR szProtocol[WSAPROTOCOL_LEN+];            contains a human-readable name identifying the protocol
 } WSAPROTOCOL_INFO, *LPWSAPROTOCOL_INFO;
 https://msdn.microsoft.com/en-us/library/windows/desktop/ms741675(v=vs.85).aspx

 typedef struct{
     ];
     ];
     PIP_ADDR_STRING CurrentDnsServer;
     IP_ADDR_STRING DnsServerList;
     UINT NodeType;
     ];
     UINT EnableRouting;
     UINT EnableProxy;
     UINT EnableDns;
 }FIXED_INFO, *PFIXED_INFO;

 typedef struct _IP_ADDR_STRING{
     struct _IP_ADDR_STRING *Next;
     IP_ADDRESS_STRING IpAddress;                //该结构体中包含字符串成员 String，描述了点分十进制 ip 地址
     IP_MASK_STRING IpMask;
     DWORD Context;                        //表示网络表入口
 }IP_ADDR_STRING, *PIP_ADDR_STRING;

 typedef struct _IP_INTERFACE_INFO{
     LONG NumAdapters;                    //指示 Adapter 数组中适配器数量
     IP_ADAPTER_INDEX_MAP Adapter[];            //
 }IP_INTERFACE_INFO, *PIP_INTERFACE_INFO;

 typedef struct _IP_ADAPTER_INDEX_MAP{
     ULONG index;                        //与此适配器关联的接口索引
     WCHAR Name[MAX_ADAPTER_INDEX_MAP];            //适配器名称
 }IP_ADAPTER_INDEX_MAP, *PIP_ADAPTER_INDEX_MAP;

 typedef struct _MIB_IFTABLE{
     DWORD dwNumEntries;                        //指定数组中入口的数量
     MIB_IFROW table[ANY_SIZE];                    //指定接口表
 }MIB_IFTABLE, *PMIB_IFTABLE;

 typedef struct _MIB_IFROW{
     WCHAR wszName[MAX_INTERFACE_NAME_LEN];            //指定接口名称
     DWORD dwIndex;                        //指定标识接口的索引
     DWORD dwType;                        //指定接口类型 MIB_IF_TYPE_ETHERNET MIB_IF_TYPE_PPP
     DWORD dwMtu;                        //指定最大传输单元
     DWORD dwSpeed;                        //接口速度
     DWORD dwPhysAddrLen;                        // bPhysAddr 所指物理地址长度
     BYTE bPhysAddr[MAXLEN_PHYSADDR];                        //
     DWORD dwAdminStatus;                        //接口管理状态，MIB_IF_ADMIN_STATUS_UP/DOWN 接口（不）可被管理
     DWORD dwOperStatus;                        //接口运行状态
     DWORD dwLastChange;                        //
     DWORD dwInOctets;                        //此接口接收到的八进制数据数量
     DWORD dwInUcastPkts;                        //此接口收到的单播封包数量
     DWORD dwInNucastPkts;                        //非单播封包
     DWORD dwInDiscards;                        //已经丢弃的封包数量（不出错的）
     DWORD dwInErrors;                        //丢弃的出错的封包数量
     DWORD dwInUnknownProtos;                        //
     DWORD dwOutOctets;                        //
     DWORD dwOutUcastPkts;                        //
     DWORD dwOutNUcastPkts;                        //
     DWORD dwOutDiscards;                        //
     DWORD dwOutErrors;                            //
     DWORD dwOutQlen;                        //发送队列长度
     DWORD dwDescrLen;                        //指定 bDescr 长度
     BYTE bDescr[MAXLEN_IFDESCR];                    //接口描述信息
 }MIB_IFROW, *PMIB_IFROW;

 typedef struct _MIB_IPADDRTABLE{
     DWORD dwNumEntries;
     MIB_IPADDRROW table[ANY_SIZE];
 }MIB_IPADDRTABLE, *PMIB_IPADDRTABLE;

 typedef struct _MIB_IPADDRROW{
     DWORD dwAddr;                            //指示 IP 地址
     DWORD dwIndex;                            //指示与 IP 地址关联的接口索引
     DWORD dwMask;                            //子网掩码
     DWORD dwBCastAddr;                        //广播地址
     DWORD dwReasmSize;                        //对已收到的数据报进行重新组装后的最大长度
     unsigned short unused1;                        //保留位
     unsigned short wType;                        //指定地址类型或状态； MIB_IPADDR_PRIMARY 主 IP 地址，DYNAMIC 动态地址，DISCONNECTED 地址在未连接的接口上，DELETE 地址将要被删除，TRANSIENT 瞬时地址
 }MIB_IPADDRROW, *PMIB_IPADDRROW;

 注册表

 基础

 unsigned  位。

 TCP 服务端模型：socket -> bind -> accept -> recv -> send -> close        // 调用 shutdown
 TCP 客户端模型：socket -> connect -> send -> recv -> close

 UDP 服务端模型：socket -> bind -> recvfrom -> sendto -> close
 UDP 客户端模型：socket -> sendto -> recvfrom -> close

 利用 netbios 获取网卡号不一定准确，因为他会得到很多虚拟网卡地址。

 实例

 WSADATA wsaData;    WSAStartup( MAKEWORD(,), &wsaData );