CAsyncSocket

A CAsyncSocket object represents a Windows Socket — an endpoint of network communication. Class CAsyncSocket encapsulates the Windows Sockets API, providing an object-oriented abstraction for programmers who want to use Windows Sockets in conjunction with MFC.

This class is based on the assumption that you understand network communications. You are responsible for handling blocking, byte-order differences, and conversions between Unicode and multibyte character set (MBCS) strings. If you want a more convenient interface that manages these issues for you, see class CSocket.

To use a CAsyncSocket object, call its constructor, then call the Create function to create the underlying socket handle (type SOCKET), except on accepted sockets. For a server socket call the Listen member function, and for a client socket call the Connect member function. The server socket should call the Accept function upon receiving a connection request. Use the remaining CAsyncSocket functions to carry out communications between sockets. Upon completion, destroy the CAsyncSocket object if it was created on the heap; the destructor automatically calls the Close function. The SOCKET data type is described in the article Windows Sockets: Background in Visual C++ Programmer's Guide.

For more information, see Windows Sockets: Using Class CAsyncSocket and related articles in Visual C++ Programmer's Guide, as well as Overview of Windows Sockets 2 and Windows Sockets Programming Considerations in the Win32 SDK documentation.

#include <afxsock.h>

Class MembersBase ClassHierarchy Chart

Samples   MFC Sample CHATSRVRMFC Sample HTTPSVR

See Also   CSocket, CSocketFile