NAME

DL_GetDbNameFromHandle

SYNOPSIS

char * CSSMDLI DL_GetDbNameFromHandle
    (CSSM_DL_DB_HANDLE DLDBHandle)

DESCRIPTION

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

PARAMETERS

DLDBHandle (input)

The handle pair that describes the add-in data storage library module used to perform this function and the open data store whose name is being requested.

RETURN VALUE

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

ERRORS

CSSM_DL_MEMORY_ERROR

Error allocating memory.

CSSM_DL_INVALID_DB_HANDLE

Invalid DB Handle.

CSSM_DL_INVALID_DL_HANDLE

Invalid DL Handle.

SEE ALSO

DL_GetDbNames