NAME
   MDS_Install - Create the object directory database (CDSA)

 SYNOPSIS
   #include <mds.h>

        CSSM_RETURN CSSMAPI MDS_Install
        (MDS_HANDLE MdsHandle)

 LIBRARY
   Module Directory Services library (CDSA$MDS300_SHR.EXE)

 PARAMETERS
   MdsHandle (input)
           The MDS handle identifying an MDS context.

 DESCRIPTION
   This function creates the Object Directory database containing the
   Object relation, and the CDSA Directory database containing the
   set of CDSA-specific relations defined in this specification. The
   MdsHandle identifies an MDS context created by invoking
   MDS_Initialize(). The context contains information about the
   access rights of the caller. Write-access is required to perform
   this operation.

 RETURN VALUE
   A CSSM_RETURN value indicating success or specifying a particular
   error condition. The value CSSM_OK indicates success. All other
   values represent an error condition.

 ERRORS
   Errors are described in the CDSA technical standard.  See CDSA.

        CSSMERR_DL_INVALID_DL_HANDLE
        CSSMERR_DL_DATASTORE_ALREADY_EXISTS
        CSSMERR_DL_INVALID_ACCESS_REQUEST
        CSSMERR_DL_INVALID_DB_LOCATION
        CSSMERR_DL_INVALID_DB_NAME
        CSSMERR_DL_INVALID_OPEN_PARAMETERS
        CSSMERR_DL_INVALID_RECORD_INDEX
        CSSMERR_DL_INVALID_RECORDTYPE
        CSSMERR_DL_INVALID_FIELD_NAME
        CSSMERR_DL_UNSUPPORTED_FIELD_FORMAT
        CSSMERR_DL_UNSUPPORTED_INDEX_INFO
        CSSMERR_DL_UNSUPPORTED_LOCALITY
        CSSMERR_DL_UNSUPPORTED_NUM_ATTRIBUTES
        CSSMERR_DL_UNSUPPORTED_NUM_INDEXES
        CSSMERR_DL_UNSUPPORTED_NUM_RECORDTYPES
        CSSMERR_DL_UNSUPPORTED_RECORDTYPE
        CSSMERR_DL_FIELD_SPECIFIED_MULTIPLE
        CSSMERR_DL_INCOMPATIBLE_FIELD_FORMAT
        CSSMERR_DL_INVALID_PARSING_MODULE

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics