This structure contains the meta-information about an entire data store. The description includes the types of records stored in the data store, the attribute schema for each record type, the index schema for all indexes over records in the data store, the type of authentication mechanism used to gain access to the data store, and other miscellaneous information used by the DL module to manage the data store in a secure manner.

typedef struct cssm_dbInfo {
    uint32 NumberOfRecordTypes;
    CSSM_DB_PARSING_MODULE_INFO_PTR DefaultParsingModules;
    CSSM_DB_RECORD_ATTRIBUTE_INFO_PTR RecordAttributeNames;
    CSSM_DB_RECORD_INDEX_INFO_PTR RecordIndexes;

    /* access restrictions for opening this data store */
    CSSM_USER_AUTHENTICATION_MECHANISM AuthenticationMechanism;

    /* transparent integrity checking options for this data store */
    CSSM_BOOL RecordSigningImplemented;
    CSSM_DATA SigningCertificate;
    CSSM_GUID SigningCsp;

    /* additional information */
    CSSM_BOOL IsLocal;
    char *AccessPath; /* URL, dir path, etc */
    void *Reserved;
} CSSM_DBINFO, *CSSM_DBINFO_PTR;

Definitions:

NumberOfRecordTypes

The number of distinct record types stored in this data store.

DefaultParsingModules

A pointer to a list of pairs (record-type, GUID) which define the default-parsing module for each record type.

RecordAttributeNames

The meta-information (schema) about the attributes associated with each record type that can be stored in this data store.

RecordIndexes

The meta- information (schema) about the indexes that are defined over each of the record types that can be stored in this data store.

AuthenticationMechanism

Defines the authentication mechanism required when accessing this data store.

RecordSigningImplemented

&tab;A flag indicating whether or not the DL module provides record integrity service based on digital signaturing of the data store records.

SigningCertificate

The certificate used to sign data store records when the transparent record integrity option is in effect.

SigningCsp

The GUID for the Cryptographic Service Provider (CSP) to be used to sign data store records when the transparent record integrity option is in effect.

IsLocal

Indicates whether the physical data store is local.

AccessPath

A character string describing the access path to the data store, such as a Universal Resource Locator (URL), a file system path name, a remote directory service name, etc.

Reserved

Reserved for future use