网络编程技术西电课件第章v.ppt

3.2.6 WSAAsyncGetXByY类型的扩展函数 WSAAsyncGetXByY类型的扩展函数是GetXByY函数的异步版本，这些函数可以很好地利用Windows的消息驱动机制。 Winsock的实现启动WSAAsyncGetXByY()操作后立即返回调用方，并传回一个异步任务句柄，应用程序可以用该句柄标识操作； 当操作完成时，如果有结果将会把结果复制到调用方提供的缓冲区buf中，同时向应用程序的窗口发一条消息； 应用程序窗口hWnd接收到消息wMsg，该消息结构的wParam参数包含了初次函数调用时返回的异步任务句柄；Iprarm参数的高16位包含错误代码。 * 1．WSAAsyncGetHostByName()函数 gethostbyname()的异步版本，用于获取对应一个主机名的主机名称和地址信息。 HANDLE WSAAsyncGetHostByName ( HWND hWnd, unsigned int wMsg, const char * name, char * buf, int buflen ); hWnd：异步请求完成时，接收消息的窗口句柄； wMsg：异步请求完成时，将要接收的消息；即定义一个消息，当函数调用返回时，将消息传递给窗口 name：指向主机名的指针； buf：接收hostent数据的数据区指针，需大于hostent结构大小，因为hostent结构引用的数据也都在该区域内。 buflen：数据区的大小。 若操作成功地初启，返回一个HANDLE类型的非0值，作为请求需要的异步任务句柄。 该HANDLE类型的值可通过WSACancelAsyncRequest()用来取消操作，也可通过检查wParam消息参数，以匹配异步操作和完成消息. * 2．WSAAsyncGetHostByAddr()函数 本函数是gethostbyaddr()的异步版本，用来获取对应于一个网络地址的主机名和地址信息. HANDLE WSAAsyncGetHostByAddr ( HWND hWnd, unsigned int wMsg, const char * addr, int len, int type, char * buf, int buflen ); hWnd 异步请求完成时，应该接收消息的窗口句柄. wMsg 异步请求完成时，将要接收的消息. addr 主机网络地址的指针，以网络字节次序存储. len 地址长度.对于PF_INET来说必须为4. type 地址类型,必须是PF_INET. buf 接收hostent数据的数据区指针. buflen 上述数据区的大小. 返回值指出异步操作是否成功地初启. 若操作成功地初启，WSAAsyncGetHostByAddr()返回一个HANDLE类型的非0值，作为请求需要的异步任务句柄. 如果异步操作不能初启,WSAAsyncGetHostByAddr()返回一个0值,并且可使用WSAGetLastError()来获取错误号. * 3．WSAAsyncGetServByName()函数 本函数是getservbyname()的异步版本，用来获取对应于一个服务名的服务信息. HANDLE WSAAsyncGetServByName ( HWND hWnd, unsigned int wMsg, const char * name, const char * proto, char * buf, int buflen ); hWnd 异步请求完成时，应该接收消息的窗口句柄. wMsg 异步请求完成时，将要接收的消息. name 指向服务名的指针. proto 指向协议名称的指针.它可能是NULL，在这种情况下,WSAAsyncGetServByName()将搜索第一个服务入口(满足s_name或s_aliases之一和所给的名字匹配.)否则, WSAAsyncGetServByName()将和名和协议同时匹配. buf 接收hostent数据的数据区指针. buflen 上述数据区的大小. 返回值指出异步操作是否成功地初启. * 4．WSAAsyncGetServByPort() 本函数是getservbyport()的异步版本，用来获取对应于一个端口号的服务信息. HANDLE WSAAsyncGetServByPort ( HWND hWnd, unsigned int wMsg, int port, const char * proto, char * buf, int buflen ); hWnd 异步请求完成时，应该接收消息的窗口句柄. wMsg 异步请求完成时