NAME
MDS_Install — Create the object directory database (CDSA)
SYNOPSIS
#include <cdsa/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. 
| CSSMERR_DL_INVALID_DL_HANDLECSSMERR_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