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

TP_TupleGroupToCertGroup

 » Table of Contents

 » Glossary

 » Index

NAME

CSSM_TP_TupleGroupToCertGroup — Create a set of certificate templates (CDSA)

SYNOPSIS

# include <cssm.h>
API:
CSSM_RETURN CSSMAPI CSSM_TP_TupleGroupToCertGroup
(CSSM_TP_HANDLE TPHandle,
CSSM_CL_HANDLE CLHandle,
const CSSM_TUPLEGROUP *TupleGroup,
CSSM_CERTGROUP_PTR *CertTemplates)
SPI:
CSSM_RETURN CSSMTPI TP_TupleGroupToCertGroup
(CSSM_TP_HANDLE TPHandle,
CSSM_CL_HANDLE CLHandle,
const CSSM_TUPLEGROUP *TupleGroup,
CSSM_CERTGROUP_PTR *CertTemplates)

LIBRARY

Common Security Services Manager library (cdsa$incssm300_shr.exe)

DESCRIPTION

This function creates a set of certificate templates based on a set of input tuples. The tuples describe a set of authorizations for one or more subjects. The trust policy service provider maps these authorizations to appropriate template values for one or more certificates of the type managed by the Trust Policy module. The resulting certificate templates can be input to a certificate creation function, such as CSSM_CL_CertSign(), (CSSM API), or CL_CertSign(), (TP SPI). The signed certificates created by these functions should carry the authorizations described in the input tuples.

PARAMETERS

TPHandle (input) 

The handle that describes the trust policy service module used to perform this function.

CLHandle (input/optional)
  

The handle that describes the certificate library module that can be used to assist in the creation of field values. If no certificate library module is specified, the TP module uses an assumed CL module, if required.

TupleGroup (input)
  

A pointer to a group of CSSM_TUPLE describing authorizations for one or more subjects.

CertTemplates (output)
  

A pointer to a structure containing references to one or more certificate templates resulting from the translation process. Storage for the structure and certificate templates is allocated by the service provider and must be deallocated by the application.

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_TP_INVALID_CL_HANDLE
CSSMERR_TP_INVALID_TUPLEGROUP_POINTER
CSSMERR_TP_INVALID_TUPLEGROUP
CSSMERR_TP_INVALID_TUPLE

SEE ALSO

Books

Intel CDSA Application Developer's Guide

Online Help

For the CSSM API:

CSSM_TP_CertGroupToTupleGroup, CSSM_AC_AuthCompute

For the TP SPI:

TP_CertGroupToTupleGroup, AC_AuthCompute