Locks an object for exclusive editing by the user
calling this function. The object can be only unlocked by this
user or the sytem user. 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_NORMAL means, an object is locked until it
is unlocked. HW_API_LOCK_RECURSIVE is only valid for collection
and locks all objects within th collection und possible
subcollections. HW_API_LOCK_SESSION means, an object is locked
only as long as the session is valid.
See also
hwapi_unlock()
.