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
