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 data storage library module and the open data store whose name should be retrieved.
`DbName` (output)
		Returns a zero terminated string which contains a data store name. The memory is allocated by the service provider and must be deallocated by the application.

DESCRIPTION

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

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_DL_INVALID_DB_HANDLE