php-doc-en/reference/hwapi/functions/hwapi-lock.xml

<?xml version='1.0' encoding='iso-8859-1' ?>
<!-- $Revision: 1.2 $ -->
<!-- splitted from ./en/functions/hwapi.xml, last change in rev 1.1 -->
  <refentry id="function.hwapi-lock">
   <refnamediv>
    <refname>hw_api->lock</refname>
    <refpurpose>Locks an object</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <methodsynopsis>
     <type>object</type><methodname>lock</methodname>
     <methodparam><type>array</type><parameter>parameter</parameter></methodparam>
    </methodsynopsis>
    <para>
     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.
    </para>
    <para>
     See also <function>hwapi_unlock</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->