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_GetDbNameFromHandle
(CSSM_DL_DB_HANDLE DLDBHandle,
char ∗∗DbName)

LIBRARY

Common Security Services Manager library (libcssm.so)

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 de-allocated 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_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)