This function retrieves the data source name corresponding to an opened database handle. A DL module is responsible for allocating the memory required for the list.

char * CSSMAPI CSSM_DL_GetDbNameFromHandle (CSSM_DL_DB_HANDLE DLDBHandle)

Input

DLDBHandle

The handle pair that describes the DL module used to perform this function and the data store to which access is being requested. If the form of authentication being requested is authentication to the DL module in general, the data store handle must be NULL.

Returns a string that contains a data store name. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.