NAME
   DL_GetDbNameFromHandle,
   CSSM_DL_GetDbNameFromHandle - Get data source name (CDSA)

 SYNOPSIS
   # include <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
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS
   DLDBHandle (input)
           The handle pair that identifies the add-in data storage
           library module and the open data store whose name should
           be retrieved.

   DbName (output)
           Returns a zero terminated string which contains a data store
           name.  The memory is allocated by the service provider and
           must be deallocated by the application.

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

 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.  See CDSA.

        CSSMERR_DL_INVALID_DB_HANDLE

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions for the CSSM API:

       CSSM_DL_GetDbNames

   Functions for the DL SPI:

       DL_GetDbNames