hw_api::lock
  Locks an object
  
 
 
  Description
  
   bool hw_api::lock
    ( array $parameter
   )
  
  
 
  Parameters
  
   
    
     - 
parameter
- 
      
       The parameter array contains the required element 'objectIdentifier'
       and the optional parameters 'mode' and 'objectquery'.
       
       'mode' determines how an object is locked.
       HW_API_LOCK_NORMALmeans, an object is locked
       until it is unlocked.HW_API_LOCK_RECURSIVEis
       only valid for collection and locks all objects within the collection
       and possible subcollections.HW_API_LOCK_SESSIONmeans, an object is locked only as long as the session is valid.
 
 
 
  Return Values
  
   Returns TRUE on success or FALSE on failure.