tfUserCreateTcpSocket

Jump to: navigation, search

Table of Contents >> Appendix D: TCP Socket Importing (Socket Migration)


#include <trsocket.h>


int tfUserCreateTcpSocket (
ttUserTcpConPtr userTcpConPtr,
int TM_FAR * errorCodePtr
);


Function Description

This function implements an advanced feature for creating a socket from a complete TCP state snapshot. Refer to the main article, TCP Socket Importing, for details.


Parameters

  • userTcpConPtr
    A pointer to a ttUserTcpCon structure that contains the TCP connection state information to be imported into the new socket.
  • errorCodePtr
    A pointer to a variable that will receive the error information.


Returns

  • >= 0
    The new socket descriptor.
  • TM_SOCKET_ERROR
    Failure. Examine the variable referenced by errorCodePtr for error information.


Possible socket errors

  • TM_EINVAL
    Invalid parameter.
  • TM_EMFILE
    Exceeded the limit on the number of sockets.
  • TM_ENOBUFS
    Not enough free memory.
  • TM_EAFNOSUPPORT
    Address family not supported.
  • TM_EADDRINUSE
    Local address is already in use.
  • TM_EHOSTUNREACH
    No route to host.
  • TM_EADDRNOTAVAIL
    Remote address is not available.
  • TM_ENOENT
    No matching outbound device.


Table of Contents >> Appendix D: TCP Socket Importing (Socket Migration)