HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > CDSA API Functions

DL_GetDbNameFromHandle

 » Table of Contents

 » Glossary

 » Index

NAME

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

SEE ALSO

Books

Intel CDSA Application Developer's Guide

Online Help

Functions for the CSSM API:

CSSM_DL_GetDbNames

Functions for the DL SPI:

DL_GetDbNames