DL_GetDbNameFromHandle(3)DL_GetDbNameFromHandle(3)NAME
DL_GetDbNameFromHandle, CSSM_DL_GetDbNameFromHandle - Get data source
name (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_DL_GetDbNameFromHandle (CSSM_DL_DB_HANDLE
DLDBHandle, char **DbName) SPI: CSSM_RETURN CSSMDLI DL_GetDbName‐
FromHandle (CSSM_DL_DB_HANDLE DLDBHandle, char **DbName)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
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 allo‐
cated by the service provider and must be de-allocated by the applica‐
tion.
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 repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_DL_INVALID_DB_HANDLE
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_DL_GetDbNames(3)
Functions for the DL SPI:
DL_GetDbNames(3)DL_GetDbNameFromHandle(3)