Windows Sockets: Socket Notifications
This article describes the notification functions in the socket classes. These member functions are callback functions that the framework calls to notify your socket object of important events. The notification functions are:
OnConnect: Notifies this connecting socket that its connection attempt completed: perhaps successfully or perhaps in error.
OnClose: Notifies this socket that the socket it is connected to has closed.
An additional notification function is OnOutOfBandData. This notification tells the receiving socket that the sending socket has "out-of-band" data to send. Out-of-band data is a logically independent channel associated with each pair of connected stream sockets. The out-of-band channel is typically used to send "urgent" data. MFC supports out-of-band data. Advanced users working with class CAsyncSocket might need to use the out-of-band channel, but users of class CSocket are discouraged from using it. The easier way is to create a second socket for passing such data. For more information about out-of-band data, see the Windows Sockets specification, available in the Windows SDK.
If you derive from class
CAsyncSocket, you must override the notification functions for those network events of interest to your application. If you derive a class from class
CSocket, it is your choice whether to override the notification functions of interest. You can also use
CSocketitself, in which case the notification functions default to doing nothing.
These functions are overridable callback functions.
CSocketconvert messages to notifications, but you must implement how the notification functions respond if you wish to use them. The notification functions are called at the time your socket is notified of an event of interest, such as the presence of data to be read.
MFC calls the notification functions to let you customize your socket's behavior at the time it is notified. For example, you might call Receive from your
OnReceivenotification function, that is, on being notified that there is data to read, you call Receive to read it. This approach is not necessary, but it is a valid scenario. As an alternative, you might use your notification function to track progress, print TRACE messages, and so on.
You can take advantage of these notifications by overriding the notification functions in a derived socket class and providing an implementation.
During an operation such as receiving or sending data, a
CSocketobject becomes synchronous. During the synchronous state, any notifications meant for other sockets are queued while the current socket waits for the notification it wants. (For example, during a Receive call, the socket wants a notification to read.) Once the socket completes its synchronous operation and becomes asynchronous again, other sockets can begin receiving the queued notifications.
OnConnect notification function is never called. For connections, you call Connect, which will return when the connection is completed (either successfully or in error). How connection notifications are handled is an MFC implementation detail.
For details about each notification function, see the function under class
CAsyncSocket in the MFC Reference. For source code and information about MFC samples, see MFC Samples.
For more information, see: