CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode Controller_SendUp ( CPHOBJECT const  hController)

Send the message related to the button up action, if any. If the controller has been assigned with a selector:

  • if a value up has been specified, the related message is sent.
  • if no value up has been set, a selector with value 0 is sent. If the controller has been assigned with a modifier:
  • if a value up has been specified, the related message is sent.
  • if no value up has been set, a modifier with value 0x0000 is sent.
    Parameters
    [in]hControllerController handle
    Remarks
    If some destination is not yet validated, the method returns ERR_SentToNotYetValidatedDestination. The message delivery is not guaranteed for those destinations.
    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.