NAME    [Toc]    [Back]

       DL_GetDbNames,  CSSM_DL_GetDbNames  -  Get list of logical
       data store names (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_DL_GetDbNames  (CSSM_DL_HANDLE
    DLHandle,    CSSM_NAME_LIST_PTR   *NameList)   SPI:
       CSSM_RETURN CSSMDLI DL_GetDbNames  (CSSM_DL_HANDLE  DLHandle,
 CSSM_NAME_LIST_PTR *NameList)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The  handle that describes the add-in data storage library
       module to be used to perform  this  function.   Returns  a
       list  of  data  store names in a CSSM_NAME_LIST_PTR structure.

DESCRIPTION    [Toc]    [Back]

       This function returns the list of logical data store names
       for  all  data  stores that are known by and accessible to
       the specified DL module. This list also includes the  number
 of data store names in the return list.

       The  CSSM_DL_FreeNameList() function must be called to deallocate
 memory containing the list.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors are described in the CDSA technical standard.   See
       CDSA_intro(3).

       None specific to this call.

SEE ALSO    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_DL_GetDbNameFromHandle(3), CSSM_DL_FreeNameList(3)

       Functions for the DL SPI:

       DL_GetDbNameFromHandle(3), DL_FreeNameList(3)



                                                 DL_GetDbNames(3)