WINC1500 IoT Software APIs: send

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]	pvSendBuffer	Pointer to a buffer holding data to be transmitted.
[in]	u16SendLength	The buffer size in bytes.
[in]	u16Flags	Not used in the current implementation.

Precondition

Sockets must be initialized using socketInit.

For TCP Socket:
Must use a successfully connected Socket (so that the intended recipient address is known ahead of sending the data). Hence this function is expected to be called after a successful socket connect operation(in client case or accept in the the server case).
For UDP Socket:
UDP sockets most commonly use sendto function, where the destination address is defined. However, in-order to send outgoing data using the send function, at least one successful call must be made to the sendto function a priori the consecutive calls to the send function, to ensure that the destination address is saved in the firmware.

See also

socketInit recv sendto socket connect accept sendto

Warning

u16SendLength must not exceed SOCKET_BUFFER_MAX_LENGTH.
Use a valid socket identifier through the a prior call to the socket function. Must use a valid buffer pointer. Successful completion of a call to send() does not guarantee delivery of the message, A negative return value indicates only locally-detected errors

Returns

The function shall return SOCK_ERR_NO_ERROR for successful operation and a negative value (indicating the error) otherwise.