1.2.3.1.48 TCPIP_TCP_SignalHandlerRegister Function

TCPIP_TCP_SIGNAL_HANDLE TCPIP_TCP_SignalHandlerRegister(
    TCP_SOCKET s, 
    TCPIP_TCP_SIGNAL_TYPE sigMask, 
    TCPIP_TCP_SIGNAL_FUNCTION handler, 
    const void* hParam
);

This function registers a TCP socket signal handler. The TCP module will call the registered handler when a TCP signal (TCPIP_TCP_SIGNAL_TYPE) occurs.

TCP valid socket.

• Returns a valid handle if the call succeeds

• Returns a null handle if the call failed (null handler, no such socket, existent handler).

Only one signal handler per socket is supported. A new handler does not override the existent one. Instead TCPIP_TCP_SignalHandlerDeregister has to be explicitly called.

The handler has to be short and fast. It is meant for setting an event flag, not for lengthy processing.

The hParam is passed by the client.

For multi-threaded systems the TCP/IP packet dispatch does not occur on the user thread. The signal handler will be called on a different thread context. It is essential that this handler is non blocking and really fast.

For multi-threaded systems, once set, it is not recommended to change the signal handler at run time. Synchronization between user threads and packet dispatch threads could be difficult. If really need to be changed, make sure that the old handler could still be called and it should be valid until the new one is taken into account. TCPIP_TCP_SignalHandlerDeregister needs to be called before registering another handler.