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 );