NAME    [Toc]    [Back]

       DL_GetDbNameFromHandle,  CSSM_DL_GetDbNameFromHandle - Get
       data source name (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:   CSSM_RETURN   CSSMAPI   CSSM_DL_GetDbNameFromHandle
       (CSSM_DL_DB_HANDLE   DLDBHandle,   char   **DbName)   SPI:
       CSSM_RETURN         CSSMDLI         DL_GetDbNameFromHandle
       (CSSM_DL_DB_HANDLE DLDBHandle, char **DbName)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The  handle  pair  that identifies the add-in data storage
       library module and the open data store whose  name  should
       be retrieved.  Returns a zero terminated string which contains
 a data store name. The memory is  allocated  by  the
       service  provider and must be de-allocated by the application.

DESCRIPTION    [Toc]    [Back]

       This function retrieves the data source name corresponding
       to an opened data store handle.

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).  CSSMERR_DL_INVALID_DB_HANDLE

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_GetDbNames(3)

       Functions for the DL SPI:

       DL_GetDbNames(3)



                                        DL_GetDbNameFromHandle(3)