MDS_Install

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

API Functions

MDS_Initialize

MDS_Terminate

MDS_Install

Library
Description
Errors

Parameters
Return Value
See Also

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_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