CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode Pipe_SendSelectorMessage ( CPHOBJECT const  hPipe,
CPSELECTORMSG const *const  pMessageData,
CPBOOLEAN const  fFlush 
)

Send an event message. For performance, this function does not wait for a response.

Parameters
[in]hPipePipe handle
[in]pMessageDataevent message data (see CPSELECTORMSG structure in CLCm_Defines.h)
[in]fFlushIf TRUE, the message is immediately prepared and sent, including prospective multipart messages added before. Setting fFlush at TRUE is the normal way to send a single message, or to specify the last and send the whole of a multipart message. If FALSE, the message is added to the multipart buffer, except if the buffer is full. In this case, the multipart message is sent, and a new one is created to store the new message.
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
Warning
This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.