connect

Functions
NMI_API sint8	connect (SOCKET sock, struct sockaddr *pstrAddr, uint8 u8AddrLen)

Detailed Description

Establishes a TCP connection with a remote server. The asynchronous connect function must be called after receiving a valid socket ID from the socket function. The application socket callback function is notified of a successful new socket connection through the event SOCKET_MSG_CONNECT. A successful connect means the TCP session is active. The application is then required to make a call to the recv to receive any packets transmitted by the remote server, unless the application is interrupted by a notification of socket connection termination.

Function Documentation

connect()

NMI_API sint8 connect	(	SOCKET	sock,
		struct sockaddr *	pstrAddr,
		uint8	u8AddrLen
	)

Parameters

[in]	sock	Socket ID, must hold a non negative value. A negative value will return a socket error SOCK_ERR_INVALID_ARG. Indicating that an invalid argument is passed in.
[in]	pstrAddr	Address of the remote server.
[in]	pstrAddr	Pointer to socket address structure "sockaddr_in" sockaddr_in
[in]	u8AddrLen	Size of the given socket address structure in bytes. Not currently used, implemented for BSD compatibility only.

Precondition

The socket function must be called to allocate a TCP socket before passing the socket ID to the bind function. If the socket is not bound, you do NOT have to call bind before the "connect" function.

See also

socket recv send close

Returns

The function returns ZERO for successful operations and a negative value otherwise. The possible error values are:

• SOCK_ERR_NO_ERROR Indicating that the operation was successful.
• SOCK_ERR_INVALID_ARG Indicating passing invalid arguments such as negative socket ID or NULL socket address structure.
• SOCK_ERR_INVALID Indicate socket connect failure.

Example

The example demonstrates a TCP application, showing how the asynchronous call to the connect function is made through the main function and how the callback function handles the SOCKET_MSG_CONNECT event.

UDP example

struct sockaddr_in  Serv_Addr;
SOCKET TcpClientSocket =-1;
int ret = -1

TcpClientSocket = socket(AF_INET,SOCK_STREAM,0);
Serv_Addr.sin_family = AF_INET;
Serv_Addr.sin_port = _htons(1234);
Serv_Addr.sin_addr.s_addr = inet_addr(SERVER);
printf("Connected to server via socket %u\n",TcpClientSocket);

do
{
    ret = connect(TcpClientSocket,(sockaddr_in*)&Serv_Addr,sizeof(Serv_Addr));
 if(ret != 0)
    {
        printf("Connection Error\n");
    }
 else
    {
        printf("Connection successful.\n");
 break;
    }
}while(1)   

TCP example

if(u8Msg == SOCKET_MSG_CONNECT)
{
 tstrSocketConnectMsg    *pstrConnect = (tstrSocketConnectMsg*)pvMsg;
 if(pstrConnect->s8Error == 0)
    {
 uint8   acBuffer[GROWL_MSG_SIZE];
 uint16  u16MsgSize;

        printf("Connect success!\n");
 
        u16MsgSize = FormatMsg(u8ClientID, acBuffer);
 send(sock, acBuffer, u16MsgSize, 0);
 recv(pstrNotification->Socket, (void*)au8Msg,GROWL_DESCRIPTION_MAX_LENGTH, GROWL_RX_TIMEOUT);
        u8Retry = GROWL_CONNECT_RETRY;
    }
 else
    {
        M2M_DBG("Connection Failed, Error: %d\n",pstrConnect->s8Error");
        close(pstrNotification->Socket);
    }
}