NAME

CSSM_DL_GetDbNameFromHandle

SYNOPSIS

char * CSSMAPI CSSM_DL_GetDbNameFromHandle
    (CSSM_DL_DB_HANDLE DLDBHandle)

DESCRIPTION

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

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.

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

CSSM_DL_GetDbNames