Two flags are supported for the SendTo operation on UDP sockets: - ISOCKET_FLAG_SENDTO_URGENT flag will attempt to deliver the message even
if the network is asleep (e.g. on a common channel instead of a dedicated channel). There will probably be limits on the size of such signaling, even if it is supported. See the INETMGR_GetOpt() function for details. This feature should be used with discretion, and requires a privilege: NET_URGENT must be specified as an external dependency in the application's MIF in order to utilize this option. It will be useful for applications with very low bandwidth requirements or applications which are sensitive to the additional network delay of waiting for the network to be awakened from dormancy. - ISOCKET_FLAG_SENDTO_WAKEUP flag can be used in conjunction with the ISOCKET_FLAG_SENDTO_URGENT
flag to concurrently request that the network should be awakened from dormancy as soon as possible, subsequent to the message delivery. If only the ISOCKET_FLAG_SENDTO_WAKEUP is set, UDP data will NOT be sent. This feature requires System privileges.
int32 ISOCKET_SendTo ( ISocket * pISocket, byte * pBuff, uint16 wBytes, uint16 wflags, INAddr a, INPort wPort )
- bytes_sent ( > 0)
Any positive number indicates the number of bytes successfully sent.
AEE_NET_WOULDBLOCK: Cannot send data at this time. Use ISOCKET_Writeable() to wait for readiness. This condition could be encountered if transmit buffers have been filled, or when a network connection is being established.
AEE_NET_ERROR: Indicates failure. The specific error code can be retrieved by calling ISOCKET_GetLastError(). One of the AEE Error Codes is returned