m_lock

This call increments the system lock count, which prevents interruption of the currently running application while it is non-zero. That is, it causes other applications' hotkeys to be ignored, prevents alarm-induced task switching, and controls background task activation.

This could be used, for example, to prevent a task-switch until after an error message is acknowledged by the user.


Syntax:         void m_lock(void) 
Parameters:     None 
Returns:        None 
Related Calls:  m_unlock 
Comments:       This call (and its complement, m_unlock) work by incrementing and 
                decrementing the lock counters.  Correct nesting is therefore required
                for use.  For example, two successive m_lock() calls, followed by a 
                single m_unlock() call, will still leave the lock on.