NAME

DL_GetDbNames

SYNOPSIS

CSSM_NAME_LIST_PTR CSSMDLI DL_GetDbNames
    (CSSM_DL_HANDLE DLHandle)

DESCRIPTION

This function returns a list of the logical data store names that the specified DL module can access and a count of the number of logical names in that list.

PARAMETERS

DLHandle (input)

The handle that describes the add-in data storage library module to be used to perform this function.

RETURN VALUE

Returns a pointer to a CSSM_NAME_LIST structure which contains a list of data store names. 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_NO_DATA_SOURCES

No known data store names.

CSSM_DL_GET_DB_NAMES_FAIL

Get DB Names failed.

CSSM_DL_INVALID_DL_HANDLE

Invalid DL Handle.

SEE ALSO

DL_GetDbNameFromHandle, DL_FreeNameList