Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

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

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents Next section Index