Method RegisterForUpdateEvent

Core/ClientSML/src/sml_ClientKernel.cpp:1947–1978

* @brief Register for an "UpdateEvent". * Multiple handlers can be registered for the same event. * @param smlEventId The event we're interested in (see the list below for valid values) * @param handler A function that will be called when the event happens * @param pUserData Arbitrary data that will be passed back to the handler function when the event happens. * @param addT

* @returns A unique ID for this callback (used to unregister the callback later)
*************************************************************/
int Kernel::RegisterForUpdateEvent(smlUpdateEventId id, UpdateEventHandler handler, void* pUserData, bool addToBack)
{
    // Start by checking if this id, handler, pUSerData combination has already been registered
    TestUpdateCallbackFull test(id, handler, pUserData) ;
    
    // See if this handler is already registered
    UpdateEventHandlerPlusData plus(0, 0, 0, 0) ;
    bool found = m_UpdateEventMap.findFirstValueByTest(&test, &plus) ;
    
    if (found && plus.m_Handler != 0)
    {
        return plus.getCallbackID() ;
    }
    
    // If we have no handlers registered with the kernel, then we need
    // to register for this event.  No need to do this multiple times.
    if (m_UpdateEventMap.getListSize(id) == 0)
    {
        RegisterForEventWithKernel(id, NULL) ;
    }
    
    // Record the handler
    // We use a struct rather than a pointer to a struct, so there's no need to new/delete
    // everything as the objects are added and deleted.
    m_CallbackIDCounter++ ;
    
    UpdateEventHandlerPlusData handlerPlus(id, handler, pUserData, m_CallbackIDCounter) ;
    m_UpdateEventMap.add(id, handlerPlus, addToBack) ;
    
    // Return the ID.  We use this later to unregister the callback
    return m_CallbackIDCounter ;
}

/*************************************************************
* @brief Register for an "StringEvent".