# hw_api->lock

(No version information available, might be only in CVS)

hw_api->lock — Locks an object

### Description

hw_api
bool lock ( array `$parameter` )

Locks an object for exclusive editing by the user calling this function. The object can be only unlocked by this user or the system user.

### 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_NORMAL` means, an object is locked until it is unlocked. `HW_API_LOCK_RECURSIVE` is only valid for collection and locks all objects within the collection and possible subcollections. `HW_API_LOCK_SESSION` means, an object is locked only as long as the session is valid.

### Return Values

Returns `TRUE` on success or `FALSE` on failure.

### See Also

- hw_api->unlock