appCORE - coreNetChanOpen()

NAME

coreNetChanOpen() -- open a UDP or Multicast channel

SYNOPSIS

include "appcore.h"

int coreNetChanOpen( coreNetChanOpenSPEC_t* s, coreHandle_t* h )

DESCRIPTION

The coreNetChanOpen() function opens a UDP or MCAST (connection-less) channel to the specified address.

PARAMETERS

s

   typedef struct  _core_net_chan_open_spec_
   {
      void* UserCntxt;

         The user's context, returned in the coreNetChanEventMsg_t

      coreNetAddrSPEC_t Address;

         The address family, address, and port to connect to.

      coreNetOptionSPEC_t Options;

         Requested channel options.

      int (*EventHandler)( coreNetChanEventMsg_t* );

         The user's thread local event handler. This function is called
         in the context of the user's thread for channel events.
   }
   coreNetChanOpenSPEC_t;

h
	pointer to coreHandle_t

RETURN VALUE

errno Value	Condition
ENOTSUP	Not supported - netCORE is not running.
EINVAL	Pointer to specification or handle is NULL.
EINVAL	The connection specification event handler is NULL.
EINVAL	The address specification is invalid.

MULTI-THREAD SAFETY LEVEL

MT-safe.