DL_CreateRelation(3)DL_CreateRelation(3)NAME
DL_CreateRelation, CSSM_DL_CreateRelation - Create a new persistent
relation (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_DL_CreateRelation (CSSM_DL_DB_HANDLE
DLDBHandle, CSSM_DB_RECORDTYPE RelationID, const char *RelationName,
uint32 NumberOfAttributes, const CSSM_DB_SCHEMA_ATTRIBUTE_INFO *pAt‐
tributeInfo, uint32 NumberOfIndexes, const CSSM_DB_SCHEMA_INDEX_INFO
*pIndexInfo) SPI: CSSM_RETURN CSSMDLI DL_CreateRelation
(CSSM_DL_DB_HANDLE DLDBHandle, CSSM_DB_RECORDTYPE RelationID, const
char *RelationName, uint32 NumberOfAttributes, const
CSSM_DB_SCHEMA_ATTRIBUTE_INFO *pAttributeInfo, uint32 NumberOfIndexes,
const CSSM_DB_SCHEMA_INDEX_INFO *pIndexInfo)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle pair that describes the add-in data storage library module
to be used to perform this function and the open data store in which to
insert the new relation record. The database should be opened in admin‐
istrative mode using the CSSM_DB_ACCESS_PRIVILEGED flag. Indicates the
type of relation record being added to the data store. Indicates the
name of the relation being added to the data store. Indicates the num‐
ber of attributes specified in pAttributeInfo. A list of structures
containing the meta information (schema) describing the attributes for
the relation being added to the specified data store. The list contains
at most one entry per attribute in the specified record type. Indi‐
cates the number of indexes specified in pIndexInfo. A list of struc‐
tures containing the meta information (schema) describing the indexes
for the relation being added to the specified data store. The list con‐
tains at most one entry per index in the specified record type.
DESCRIPTION
This function creates a new persistent relation of the specified type
by inserting it into the specified data store. The pAttributeInfo and
pIndexInfo specify the values contained in the new relation record.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_DL_FIELD_SPECIFIED_MULTIPLE CSS‐
MERR_DL_INVALID_ATTRIBUTE_INFO CSSMERR_DL_INVALID_DB_HANDLE CSS‐
MERR_DL_INVALID_INDEX_INFO CSSMERR_DL_INVALID_RECORDTYPE
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_DL_DestroyRelation(3)
Functions for the DL SPI:
DL_DestroyRelation(3)DL_CreateRelation(3)