Open a table in the data dictionary
──────────────────────────────────────────────────────────────────────────────

 Syntax

        H_OpenDataDict( cTable , nTimeOut , lExclusive )

 Arguments:

      cTable     - Table to open
      nTimeOut   - Number of retries before timeout- defaults to 0
      lExclusive - If .T., open the table exclusive

 Returns:

      .T. if table opened
      .F. otherwise

 Description:

      A routine to open a table and all associated indexes as specified
      in the Data Dictionary.  The presence of all relevant files (memo
      tables, audit tables, trashcan tables, etc.) is ensured, and the
      structures are checked against the definitions of the dictionary.
      The index keys are checked, and the file is opened in the required
      mode.
      The Data Dictionary files MUST be opened by calling H_InitDataDict()
      before calling this routine.

 Examples:



 Header File: H_LIB52.CH

 Source: OPENDICT.PRG

 Author:  Martin Colloby