DL_GetDbNameFromHandle

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

API Functions

DL_GetDbAcl

DL_GetDbNames

DL_GetDbNameFromHandle

Library
Description
Errors

Parameters
Return Value
See Also

NAME

DL_GetDbNameFromHandle: CSSM_DL_GetDbNameFromHandle - Get data source name (CDSA)

SYNOPSIS

# include <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 (cdsa$incssm300_shr.exe)

PARAMETERS

`DLDBHandle` (input)
		The handle pair that identifies the add-in datastorage library module and the open data store whose name shouldbe retrieved.
`DbName` (output)
		Returns a zero terminated string which containsa data store name. The memory is allocated by the service providerand must be deallocated by the application.

DESCRIPTION

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

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_DL_INVALID_DB_HANDLE